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Introduction 


This LAROMACS user’s manual describes the February 1988 version of LARCMACS, the 
T^X macro set used by the Technical Editing Branch (TEB) at NASA Langley Research 
Center. These macros were developed by the authors to facilitate the typesetting of NASA 
formal reports. They are also useful, however, for informal NASA reports and other technical 
documents such as meeting papers. LARCMACS are distributed by TEB for the convenience 
of the Langley T^X user community. A copy can be obtained by contacting TEB. 

LARCMACS were developed and intended to be used as an extension of Plain T^X. The 
rare instances where Plain macros have been altered or redefined are documented. 

There are some minor differences between LARCMACS and the actual macro set used in 
production at TEB, mostly relating to a few fonts that are available at TEB but not elsewhere. 
In all instances, references to these fonts in LARCMACS have been changed to similar standard 
Plain TgX fonts. Currently, LARCMACS are based on the original “am” series of T^jX fonts. 
Future releases will be upgraded to incorporate the newer “cm” fonts. 

This manual is intended to document LARCMACS so that novice I^X users can understand 
and use them. Some T^X experience, as well as access to a copy of The T^Xbook (ref. 1), will 
occasionally be helpful. Familiarity with some of Plain TgjX’s basic macros is assumed. For the 
benefit of more advanced users, the actual code for the complete set of LARCMACS macros is 
included in appendix A. 

The format for each macro description is patterned after most UNIX user manuals. The 
following subheadings are used as follows, where appropriate: 

NAME 

List the name and short description of the macro. 


SYNTAX 

Describe command syntax. Typewriter type indicates characters to be typed literally. 
Italic type indicates arguments* (characters not typed literally). Square brackets ([ ]) enclose 
optional arguments. Ellipses (...) indicate something that can be repeated. 

DESCRIPTION 

Provide detailed descriptions of the function and usage of a macro. Also describe arguments, 
syntax variations, and effects of macro options. 

EXAMPLE 

Provide an example of how a macro is intended to be used and the context. 
RESTRICTIONS 

Describe known restrictions or limitations on the use of the macro. 


* In this manual, the term argument refers to a value supplied by the user and used by a macro during a 
single invocation of the macro. 


FILES 

List related files that are either part of the macro or are used during execution. 
SEE ALSO 

List references to related entries and to other documents. 
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Installation and Use 


The best way to install these macros is to copy the whole set of files to the “INPUTS” 
subdirectory in the TgX hierarchy of files on your computer. Everyone who uses on your 
system will then have access to LARCMACS, and multiple copies will not be necessary. 

Different operating systems may have slightly different names for the directory 

structure. For example, with the Personal T^X, Inc., version of PCT^X, the LARCMACS 
files should be loaded into the PCTEX>TEXINPUT directory. 

An alternative is to install the files directly into the area where you will be running TgX. 

The February 1988 version of LARCMACS should include the following set of files: 
bigfonts.tex, cosati.tex, dblcol.tex, larcmacs.tex, sans.tex, slidefnt.tex, 
and splitcol.tex. (A file draft.tex is also available to produce a very readable rough 
draft. This file may be used without LARCMACS, but is compatible with them. See the 
instructions at the beginning of draft.tex.) 

Once the files are in place, simply include 

\input larcmacs 


at the top of your document. 

If you already have a macro file that you input at the beginning of all of your documents, 
you could include the “\input larcmacs” in that file. 

PCTgX users have a few additional considerations when using LARCMACS: 

• Use the “/f =25000” option when running TfeX. For example to process a file named stuff.tex, 

enter: 

tex stuff /f=25000 

• The FILES and BUFFERS parameters in the CONFIG.SYS file should be increased. 

FILES=32 and BUFFERS=25 seem to work well. 

For consistency and maintainability, please make it a practice not to edit any of the 
LARCMACS files. If changes are desired, macros may be redefined and parameter values 
reset in your own macro files or document files. The most recent definition always holds. 
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General Format and Parameters 


The format recommended by NASA Headquarters for NASA reports is shown in figure 1. 
The typical typeset page is laid out in two columns, each 20 picas wide, with 2 picas between 
columns. The resulting page width is 42 picas. Column, or page, length is 55 picas, not 
counting the page numbers, which appear at the bottom outside edges of the pages. Double- 
column format is not appropriate for some information, for example, matrix equations, tables, 
or this manual; thus some reports may be laid out in a single column or in a combination of 
double and single columns. The three standard heading levels are shown in figure 1, along with 
sample footnotes, numbered items, and the formal closure. Appendix B includes a sample of a 
complete NASA report. 

Note that the page layout is specified in standard typographic units of measurement. Those 
not familiar with this measurement system should read Chapter 10 of The IfcXbook (ref. 1) or 
an introductory book on typography such as reference 2. 

TgjX provides a myriad of parameters* that can be used to vary both the style of the output 
and the manner in which a document is processed. For NASA reports, the Plain TfcjX default 
settings were allowed to remain as often as possible. Only the following parameters have been 
changed: 

\baselineskip is affected by the macros in LARCMACS that change the type size. Different 
size fonts have different amounts of \baselineskip associated with them. With the 10-point 
default font, \baselineskip is set to 12 points. (This is the same as the Plain TgX default.) 

\abovedisplayskip affects the spacing above a displayed equation. It was changed to w 12pt 
plus 2pt minus 2pt” to decrease the amount of stretching and shrinking around equations 
for more uniform appearance. 

\belowdisplayskip was set to the same dimension as \abovedisplayskip. The spacing below 
an equation is affected. 

\tolerance was increased to 1500 from Plain T^gX’s default of 200, indicating that lines with 
a “badness"’ of up to 1500 will be tolerated. Experience and experimentation have shown 
this to be a more practical value in daily production. 

\pretolerance was increased to 500 from Plain TfcX’s default of 100, meaning that T^X should 
not attempt to hyphenate a line until “badness” reaches this level. Like \toIerance, this 
value was chosen through experimentation. 

\hoffset was set to -0.25 inch. This value may need to vary depending on what output device 
is being used. 

\voffset was ^et to 0 inch to conserve paper on continuous roll output devices. This value may 
also need to vary with different output devices. 

\parindent was set to 1.5 ems to conform to NASA specifications. 

\hsize was set to 42 picas for NASA specifications. 

\vsize was set to 55 picas for NASA specifications. 

If you prefer different parameter settings, please do not edit the LARCMACS files. In fact, 
for consistency, please do not edit the LARCMACS files at all. It is good practice to make 

* In this manual, the term parameter refers to a specific dimension or value that affects some overall aspect 
of the format of T£X*s output, for example, page width. 
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Indent 
1.5 ems 


Introduction 


♦—♦The analysis of structures made from boron/alumi- 
num laminates is complicated by the inelasticity and 
nonlinearity of the stress-strain behavior in the working 
range of the material. Although the mechanical prop- 
erties of boron/aluminum laminates have been studied 
(see, for example, refs. 1, 2, and 3), the stress-strain 
behavior has not been adequately rh*rarteri7ed 
The objective of this invest} Footnote. 
ize the stress-strain behavior of several types of Jsorsi£/ 


aluminum laminates. Two of the laminate types con- 
sisted of only 0° or 45° plies; three other laminate 
types contained both 0° and 45° plies. Both longitu- 
dinal and transverse stress-strain curves were obtained 
for the various laminates. To investigate the inelastic- 
ity of the material, some specimens were also subjected 
to a few loading cycles. The Ramberg- Osgood equa- 
tion was fitted to the experimental stress-strain data. 
Elastic constants and the extent of the linear regions in 
the stress-strain curves were determined for the various 
laminates. Elastic constants calculated from laminate 
theory were compared with measured values. 

Heading* 11 point* 

Is t level Results and Discussion 


2nd level 
3 Ad level 


Static Tensile Tests 


9 points 
9 points 


Stress-strain curves . Stress-strain curves 2 for the 
static tensile tests are presented in figures 4 to 8 for each 
laminate orieptatioiw-«Each figure shows the measured 
strains in th4y-}nn x-directions and average R&mberg- 
Osgood curve^Tl re j T^sult8 for longitud inal and trans- 
verse specimens xr dj tallc 4 t/mbolA J graphs in each 
figure. Note that lor laminates containing 0° fibers, 
the stress scales for longitudinal and transverse tests in 
parts (a) and (b) of the figures differ by as much as a 
factor of 10. In general, the stress-strain curves are very 
nonlinear, and the Raxnberg-Osgood curves model the 
experimental ones well. The curves are shown to fail- 
ure. Tables I to V present various parameters measured 
in the tests or calculated from the data, including the 
Ramberg-Osgood constants. 

Figure 9 shows average Ramberg-Osgood stress- 
strain curves for all the laminates. The ultimate tensile 
strains e tu of the four laminates with fibers in the di- 
rection of loading are about the same, 0.007 to 0.008. 
(See fig. 9(a).) In transverse tests of the four laminates, 
with some fibers normal to the loading direction, the 
ultimate tensile strains were much smaller and varied 
greatly, 0.0020 to 0.0065. For (±45] 2 $ laminate orien- 
tations, the ultimate tensile strains were much higher 


1 Borsic: trademark of United Aircraft Products, Inc. 

2 Note that the linear region of the stress-strain curves, for 
which the elastic constants were calculated, does not characterise 
the laminates over a significant part of their working range. 


than the 0.02 to 0.03 at which the gages failed; the} . . . 

ultimate strain given by the average Ramberg-Osgood > ^ 9 
equation for the average measured ultimate stress of) 

220.6 MPa is 0.05. 


Ultimate tensile strengths. Figure 16 shows a 
comparison between experimental and predicted tensile 
strengths for the various boron/aluminum laminates. In 
the figure, ultimate tensile strengths are plotted against 
the percentages of 45° plies in the laminates. The 
symbols are plotted at the average of the experimen- 
tal results and the tick marks indicate the extremes. 
The difference between the strengths of [±45/02]$ and 
[0 2 /±45]$ specimens indicates a small effect of stacking 
sequence on strength. 


Cyclic Tensile Tests 


Three loading cycles did not affect the stress and 
strain at failure for any of the boron/aluminum lami- 
nates. The ultimate tensile stress and strain for each 
cyclic test are presented in table VII, and these val- 
ues are within the extremes for the static tests given 
in tables I to V. However, the laminates exhibited per- 
manent strain on unloading. The permanent strains, 
which increased with applied stress and with the pro- 
portion of 45° plies, were significant — especially for the 
[±45] 2 $ laminate. 

12 points 

Summary of Results & points 


The tensile behavior of five types of boron/alumi- 
num laminates ([Qjsr, [±45]$, [0/ ± 45]$, (0 2 / ± 45]$, 
and [± 45 / 02 ) 5 ) was investigated. The following were 
concluded from the study: 


1. For the laminates with 0° plies in the loading di- 
rection, the ultimate strengths varied linearly with 
the percentage of 0° plies in the composite. The 
strengths predicted by assuming that the 0° plies 
failed first correlated well with the experimental 
results. 

2. The stress-strain curves for all the laminates were 
nonlinear except at strains below about 0.00025. In 
the linear region, measured Young’s modulus and 
Poisson's ratio were within 10 to 20 percent, respec- 
tively, of those calculated from laminate theory. 


6 points 
btioxe. 6 
a&teA tist 


The Ramberg-Osgood equation fitted to the stress- 
strain curves to obtain average curves for the various 
laminates agreed with the experimental data* 


2 picas 


Langley Research Center 1 

National Aeronautics and Space Administration r Formal 

Hampton, VA 23665 1 closuAC 

February 13, 1981 ) 


Figure 1. Basic format for typeset NASA report. Note that this page is a sample of typesetting 
style and is not necessarily sensible writing. 
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desired changes in your own files (either in your own macro file or directly at the top of your 
document). For example, Plain T^X sets the \hsize parameter to 6.5 inches. LARCMACS 
resets it to 42 picas. Suppose you usually prefer \hsize to be 6 inches, but have an unusual 
document where you want the \hsize to be 5.2 inches. The beginning of your document could 
look like this: 


\input larcmacs 
\ input mymacros 

\hsize=5.2in 


•/.initially \hsize=6.5in (Plain TglC) 
•/Ahsize changed to 42pc 
•/.your macro file changes \hsize 
•/, to usual preference: 6in 

•/.change \hsize for this doc only 
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Format Macros 


The format macros contained in this section are perhaps the most important and most used 
macros in LARCMACS. These are the macros that produce the standard NASA format for 
technical reports: 

• Two macros are available to produce two-column format, \doubIecol and \splitcol. 

• Macros to change the type size are very important. Using \magnification macro 

to change type size has the disadvantage that the type size can be changed only once for 
the entire document. The LARCMACS font size macros allow type size to be changed 
repeatedly throughout a document. 

• LARCMACS contain three macros, \levelone, \leveltwo, and \levelthree, to produce the 
three standard levels of headings shown in figure 1. Also the macro \contents produces a 
Contents page if the heading macros are used in a document. 

• Macros are included to produce footnotes and reference lists in the standard NASA format. 

• Space for figures can be left in the text by using the LARCMACS \figure, \midfigure, and 
\figurepar macros; or a list of figure captions can be produced with \figleg. 

• Running heads can be produced with \runhead, vertical spacing can be more precisely 
controlled with \solidmedskip, and large titles can be produced with \tlfont. 

• Finally the NASA Report Documentation Page appearing as the last page of every NASA 
report can be produced with the cosati macros. 
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NAME 


doublecol— double- column format 

SYNTAX 

\doublecol 

DESCRIPTION 

The \doublecol macro, if specified at the top of a document, will cause the entire document 
to be typeset in two columns. NASA formal reports are usually produced in double-column 
format, with the exception of some reports with an abundance of wide equations and figures 
that look better in single-column format. Draft versions of a document should never be in 
double-column format in order to facilitate reviewing and editing. 

Specific features of double-column format are as follows: 

• The \hsize and \vsize parameters are changed to refer to the dimensions of a single column, 
and a new parameter, \fullhsize, is introduced to refer to the total width of a page (the total 
width of both columns plus space between). It is safe to change these parameter values, if 
desired, without affecting any other features of the double-column format. The values of 
these parameters, by default, are 

\hsize-20pc 

\vsize=55pc 

\fullhsize=42pc 

• Plain TJ^X macros that previously applied to entire pages now apply only to a single column. 
For example, the macro \eject now ejects a column instead of a whole page, and all the 
insert macros (\topinsert, \pageinsert, and \midinsert) and the \footnote macro, now apply 
to single columns instead of entire pages. A new macro, \fullpageinsert, is defined to leave 
an entire blank page (both columns). 


EXAMPLE 

A document to be in double-column mode could begin like this: 

\input larcmacs 
\doublecol 


(See appendix B for sample output.) 

RESTRICTIONS 

• There is no easy way to use this macro to switch back and forth between double- and 
single-column format. The entire file is processed in double-column format. 

• The columns on the last page are not balanced and there is no easy way to perform that 
task without cutting and pasting. 
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FILES 


dblcol.tex 
SEE ALSO 

The 3] gXbook, page 257 (ref. 1) 
\splitcol 


NAME 


splitcol — alternate method for double-column output 

SYNTAX 

\splitcol 

DESCRIPTION 

This output macro was developed as an alternative to \doublecol for producing double- 
column format, in response to the restrictions mentioned with that macro. The \splitcol macro 
has the advantages that provisions are made for balancing columns and for switching back and 
forth between double- and single-column format. 

The \splitcol macro introduces some new parameters that control page format: 

\pageheight controls the total height of a page and is set to 55 picas. 

\pagewidth controls the total width of a page and is set to 42 picas. 

\colwidth controls the width of columns in double-column format and is set to 20 picas. 

\bigcolheight is a parameter used by \splitcol for balancing columns and is set to 112 picas. 
It must be slightly more than twice the page height. 

These parameters can be adjusted after the \splitcol macro if desired. To improve 
the readability of 10-point type in single-column format, \splitcol changes \baselineskip to 
13 points. In double-column format the \baselineskip remains at 12 points. 

After specifying \splitcol. the following formatting commands are available: 

• \begindoublecol begins double-column format. Single-column pages will be produced (by 
default) until the appearance of this command. 

• \enddoublecol causes the columns to be balanced and changes the format back to 
single column. When a file ends in double-column format, \enddoublecol should precede 
\vfill\eject (or \bve) at the end of the file. 

• \columnbreak strongly encourages a break for the left column (see restrictions). This 
command must be used in vertical mode or inserted with \vadjust. 

• \shortcol preceding \enddoublecol allows the right column to be slightly shorter when 
balancing columns. 

EXAMPLE 

A document that begins in single-column and changes to double-column format would look 
like this: 

\splitcol 

Document begins in one column 
\begindoublecol Change to two columns 

\enddoublecol Columns are balanced; change to one column 
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\bye 

(See appendix B, p. 115, for sample output.) 

RESTRICTIONS 

• There can he no inserts or footnotes in a file using \splitcoI. (It is possible that \pageinsert 
will work.) It may be possible to work around this restriction by splitting a document into 
more than one file and using \doublecol and \splitcol as necessary. 

• It is tricky to force left column breaks. The \columnbreak command is provided to encourage 
a break. Attempting to use \eject in the left column will result in a blank right column. 

FILES 

splitcol.tex 

SEE ALSO 

The TfiKbook, page 417 (ref. 1) 

TUGboat , vol. 6, p. 29 (ref. 3) 

\doublecol 
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NAME 


font size macros — macros to change the type sizes 


SYNTAX 

\sevenpt \tenpt 

\eightpt \elevenpt 

\ninept \twelvept 

DESCRIPTION 

All these macros change the current family of fonts to a new set of fonts at the specified 
type size. A font family is a set of typefaces (for example, roman, boldface, italic) that match 
or complement one another so that they look correct together. 

By default, \bf, \it, \sl, etc., all refer to the 10-point size. Requesting a different size, via 
any of the above macros, will cause all of the related macros (\bf, \it, . . .) to change to refer 
to the new size. 


EXAMPLE 


\sevenpt 

The Ait quick} brown fox jumps over the Abf lazy} dogApar 
\eightpt 

The Ait quick} brown fox jumps over the Abf lazy} dogApar 
\ninept 

The Ait quick} brown fox jumps over the Abf lazy} dogApar 
\tenpt 

The Ait quick} brown fox jumps over the Abf lazy} dogApar 
\elevenpt 

The Ait quick} brown fox jumps over the Abf lazy} dogApar 
\twelvept 

The Ait quick} brown fox jumps over the Abf lazy} dogApar 


yields 

The quick brown fox jumps over the la zy dog. 

The quick brown fox juarips over the lazy dog. 

The quick Brown fox jumps over the lazy dog. 

The quick brown fox jumps over the lazy dog. 

The qkick brown fox jumps over the lazy dog. 
The quick brown fox jumps over the lazy dog. 

FILES 

bigfonts.tex (for \elevenpt and \twelvept) 
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RESTRICTIONS 

Using these macros immediately before or after a displayed equation may affect the space 
above and below the equation and may change the baselineskip of the surrounding text. 

SEE ALSO 

math font size macros— \eightptmath, \nineptmath, \tenptmath 


13 



NAME 


levelone NASA format first level (of three) heading 
SYNTAX 

\levelone{heading > 

DESCRIPTION 

LARCMACS provides three levels of headings. The \levelone macro produces a heading in 
the following level-one style: 

• Twelve-point, bold, roman font 

• Left justified 

• Followed by \medskip with page break prevented 

• Hyphenation and page breaks are prevented within long headings 

A \bigskip should precede \levelone to provide appropriate space above the heading. 

EXAMPLE 

\bigskip 

\levelone{Sensitivity Study Results} 

yields 

Sensitivity Study Results 

(See other examples in appendix B.) 
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NAME 


leveltwo — NASA format second level (of three) heading 
SYNTAX 

\le veltwof /leading} 

DESCRIPTION 

LARCMACS provides three levels of headings. The \leveltwo macro produces a heading in 
the following level-two style: 

• Ten-point, bold, roman font 

• Indented on left (all lines of heading indented) 

• Followed by \medskip with page break prevented 

• Hyphenation and page breaks prevented in long headings 

A \bigskip should precede \leveltwo to provide appropriate space above the heading. 

EXAMPLE 

\bigskip 

\leveltwo{Eff ect of Vortex-Lattice Distribution} 

yields 

Effect of Vortex-Lattice Distribution 

(See other examples in appendix B.) 
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NAME 


levelthree — NASA format third level (of three) heading 
SYNTAX 

\levelthree{/ieadmg} 

DESCRIPTION 

LARCMACS provides three levels of headings. The \levelthree macro produces a heading 
in the following level-three style: 

• Ten-point slanted font (the standard NASA format calls for bold italic, which is not available 
with am fonts) 

• Preceded by small vertical skip (2 points) 

• Indented like a normal paragraph (first line only) and run into paragraph 

• Text of heading followed by (bold) period 

A \bigskip may precede \levelthree to set off the heading. 

EXAMPLE 

\big8kip 

\levelthree{No-f low condition} 

One of the fundamental conditions of vortex-lattice theory is the 

\lq\lq no-flow* ' condition at the control point of each vortex panel. This 

\ellipse 


yields 

No-flow condition . One of the fundamental conditions of vortex- lattice theory is the “no- 
flow 1 ' condition at the control point of each vortex panel. This . . . 

(See other examples in appendix B.) 
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NAME 

contents — automatic table of contents generation 
SYNTAX 

\contents 

DESCRIPTION 

Including \contents at the beginning of a document will result in the generation of a Contents 
page in a separate file. You are queried for a file name for the Contents page as I^X processes 
the original document. Any valid file name is acceptable with the following considerations: A 
.tex extension will be added to the name you select; do not select contents for the file name. 

After T^X has completed processing the original document, a new file will exist with the 
name you specified, as described above. This file contains the table of contents in T)gX format. 
To see the file with a preview program or to print a hard copy of it, the file must first be 
processed with T£X. 

The Contents will begin with page number iii and will contain all the headings in the original 
document that were produced with the \levelone, Meveltwo, and Mevelthree macros. It will be 
in a leader table format including the correct page numbers corresponding to the location of 
the headings in the original document. 

EXAMPLE 

See the Contents page of this document. It was produced by including \contents at the 
beginning of the file containing this document. 

See appendix B for an additional example. 
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NAME 


leftitem — flush left version of \item 

SYNTAX 

\leftitem<re/marfc> 

DESCRIPTION 

This macro was designed to produce the References section that appears in most NASA 
formal reports. It produces a blocked paragraph, with each line indented, and the refmark at 
the left margin before the first line. 

The refmark can be any text, usually a number or bullet of some kind. Note that the 
numbers or bullets are aligned on the left. 

EXAMPLE 

\leftitem{l .}Federal Aviation Adm. : {\it Integrated FAA Wind Shear 

Program Plan.} DOT/FAA/DL-87/1 , DOT/FAA/VS-87/1 . DOT/FAA/AT-87/1, 

U.S.\ Dep.\ of Transportation, Apr. *1987. 

\leftitem{2.}National Research Council: {\it Low-Altitude Wind Shear and 

Its Hazard to Aviation}. National Academy Press, 1983. 

\vdots 

\leftitem{10 . }Payne , Francis~M. ; and Nelson, Robert “C. : 

Aerodynamic Characteristics of an Airfoil in a Nonuniform Wind Profile. 

<\it J.~Aircr.}, vol.~22, no.*l, Jan.\ 1985, pp.*5 — 10. 

\leftitem{ll . }Frost , Walter; and Hutto, Enice: The Influence of 

Wind Shear on Aerodynamic Coefficients. <\it Sixth Conference 
on Aerospace and Aeronautical Meteorology}, American Meteorological 
Soc., Nov.\ 1974, pp. *317— 324. 

yields 

1. Federal Aviation Adm.: Integrated FAA Wind Shear Program Plan. DOT/FAA/DL-87/1, 
DOT/FAA/VS-87/1, DOT/FAA/AT-87/1, U.S. Dep. of Transportation, Apr. 1987. 

2. National Research Council: Low-Altitude Wind Shear and Its Hazard to Aviation . National 
Academy Press, 1983. 


10. Payne, Francis M.; and Nelson, Robert C.: Aerodynamic Characteristics of an Airfoil in a 
Nonuniform Wind Profile. J . Aircr., vol. 22, no. 1, Jan. 1985, pp. 5-10. 

11. Frost, Walter; and Hutto, Enice: The Influence of Wind Shear on Aerodynamic Coefficients. 
Sixth Conference on Aerospace and Aeronautical Meteorology , American Meteorological Soc., 
Nov. 1974, pp. 317 324. 

(See also the References section in appendix B, p. 113.) 

SEE ALSO 

\item, p.102, The TgXbook (ref. 1) 
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NAME 


fa — variation of \footnote macro, resulting in a smaller size footnote 

SYNTAX 

\in{symbol}{text} 

DESCRIPTION 

The \fa macro is similar to (and, in fact, based on) T^gX’s \footnote macro. The advantage 
of \fn is that it causes the text of the footnote to be in a smaller type size (8 point). 

The symbol argument is the reference mark which will appear both at the place where \fn is 
specified and at the bottom of the page with the footnote. If a superscripted reference symbol 
is preferred (this is usually the case if numbers (preferred for NASA format) or letters are used 
for the symbol), the math notation for superscripting may be included in the argument. 

The text argument includes the entire text of the footnote. 

EXAMPLE 

The footnote 1 on this page was produced with the following: 

The footnote\fn{$~l$HThis is a sample footnote.} on this page ... 


SEE ALSO 

\footnote, pp. 116-117, The TgjXbook (ref. 1) 


1 This is a sample footnote. 
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NAME 


figure — provides space for figures at the top of text pages and typesets captions 
SYNTAX 

\f igUTe{figureheight}{ caption > 

DESCRIPTION 

The \figure macro is convenient to use when you want to insert, into the text, figures that 
must be produced on a device other than the final output device for the text. It results in 
the specified amount of space left in the appropriate place and a caption typeset in a slightly 
smaller (9- point) version of the roman text font. 

The figureheight argument is used to specify the height of the figure, in any valid dimension, 
and the caption argument specifies the text to be used as a figure caption. The caption should 
be short enough to appear on one line, centered, under the figure. 

The specified amount of space, with the caption centered underneath, will appear at the top 
of either the current or following page or column. T^X’s \topinsert macro is used to determine 
placement. 

EXAMPLE 


\figure{l 82in}{Figure 2. Side view of vortex panel.} 

results in the output on p. Ill of appendix B. 

RESTRICTIONS 

Caption must fit on one line. 

SEE ALSO 

\topinsert references from The T^Kbook (ref. 1) 
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NAME 


midfigure provides space for figures within text and typesets captions 
SYNTAX 

\midf igure{figureheight}{caption} 

DESCRIPTION 

The \midfigure macro is identical to \figure except that it is based on IfcX’s \midinsert 
macro instead of \topinsert. The result is that T£X first attempts to put the entire figure, with 
caption, in the column or page at the place where the reference occurs. If it does not fit, T£X 
finds a place at the top of the next page or column. 

EXAMPLE 


\midfigure{2.5in}{Figure 1. Body-axis system.} 

results in the output on p. Ill of appendix B. 

RESTRICTIONS 

Caption must fit on one line. 

SEE ALSO 
\ figure 

\topinsert, \midinsert references in The T^Xbook (ref. 1) 
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NAME 


figurepar— provides space for figures at the top of text pages and typesets long captions 
SYNTAX 

\f igureparf/tj/ure/ietg/i/H caption} 

DESCRIPTION 

The \figurepar macro is used identically to \figure except that the figure caption can be 
longer than one line. 

The caption is typeset in a 9- point roman font, in paragraph form, with hanging indentation. 
EXAMPLE 


\figurepar{l .44in}{Figure 3. View along the $X$-axis of the left side of 
planform with dihedral.} 

results in the output on p. 112 of appendix B. 

SEE ALSO 
\figure 
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NAME 


figleg — figure captions 

SYNTAX 

\figleg{caphon> 

DESCRIPTION 

The \figleg macro is actually used by the \figurepar macro to produce the figure caption, 
but may also be useful independently. It generates a single paragraph with hanging indentation. 

The caption argument specifies the entire caption paragraph. 

EXAMPLE 


\figleg{Figure 9. Vibration mode shapes for the cantilevered 
hexahedral grid shown in figure" 10. Numbers in parentheses are exact 
frequencies (in hertz) ; other numbers are continuum plate 
frequencies .} 


yields 

Figure 9. Vibration mode shapes for the cantilevered hexahedral grid shown in figure 10. 
Numbers in parentheses are exact frequencies (in hertz); other numbers are continuum 
plate frequencies. 
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Format Macros 


NAME 

runhead — creates running headlines 
SYNTAX 

\runhead{/iea<f /ine} 

DESCRIPTION 

The headline created by this macro is centered in 10-point roman type across the top of 
each page until it is redefined. Often publications will use running headlines to put titles at 
the top of each page. 

EXAMPLE 

The following created the running headline on this page: 

\runhead{Format Macros} 
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NAME 


cosati— automatic Report Documentation Page (“cosati”) generation 

SYNTAX 

\beginco8ati 

\one{ boxcontents} 

\two{ boxcontents} 

\three{ boxcontents} 


\ twenty two{ boxcontents} 

Xendcosati 

DESCRIPTION 

The Report Documentation Page (RDP), often called the abstract or cosati page, appears as 
the last page of every published NASA report. The cosati page macros included in LARCMACS 
can be used to generate the entire form. The cosati macros can be used in a “fill in the blank” 
manner. Specify only the numbered boxes on the form that are to be filled in. 

Specify for boxcontents the text to be entered in each box. The boxcontents argument may 
be an entire paragraph where applicable, for example, in box \sixteen, which contains the 
abstract. 

Some boxes in the cosati form require multiline text. In these, a double backslash (\\) may 
be used to indicate where the line breaks should occur within the boxcontents argument. 

EXAMPLE 

See the cosati page (and the code used to generate it) on page 116 in appendix B. 

FILES 

cosati . tex 
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Table Macros 


NASA format has traditionally called for both vertical rules and cross rules in tables with 
more than two columns. Two-column tables are usually produced without rules, but with 
leaderwork (rows of dots) between the columns. This section documents macros for tables in 
NASA report format: 

• The basic format for tables can be set up with four basic table macros, \table, \boxtable, 
\ruledtable, and \hardboxtable. 

• Symbol lists (a unique type of table appearing in most NASA reports) can be arranged in 
three formats by using \symboltable, \SYMBOLTABLE, or \indentsymtab. 

• Within tables, \tablerule produces cross rules, \tableskip produces vertical space, and 
\widehead and \boxhead produces column headings. 

• Leaderwork tables are easy to set up with \leaderfill, \twodots, \threedots, and the leader 
line macros. \1, \ql, and \qql. 

This section begins with the macros used within tables and then documents the more 
complicated macros (e.g., \table) which set up overall format for tables. 


NAME 


tablerule— horizontal rule within a table 

SYNTAX 

\tablerule 

DESCRIPTION 

The \tablerule macro is to be used within a table to produce a horizontal rule, or line, all 
the way across the table. It may be inserted following any \cr within a table. 

The resulting rule has a thickness of 0.4 point. 

EXAMPLE 

\boxtable{\hsizeM#\hfill ft \vrule# * #\hfill \cr 
\hfill\Bigstrut Advantages ftft \hfill Disadvantages \cr 
\tablerule 

Simple, fast kb Does not enhance high frequency\cr 
Requires little storage bk Inaccurate regional values\cr 
Popular bk Inaccurate harmonic components \cr 
Does not require complete data set k \ cr 
Accurate global mean ft\cr> 


yields 


Advantages 

... ■ 

Disadvantages 

Simple, fast 1 

Requires little storage 

Popular 

Does not require complete data set 
Accurate global mean 

Does not enhance high frequency 
Inaccurate regional values 
Inaccurate harmonic components 
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NAME 


tableskip — medium vertical skip within a table 

SYNTAX 

\tableskip 

DESCRIPTION 

The \tableskip macro is used with alignments to produce a vertical space equivalent to a 
\medskip. It may be inserted following any \cr within a table. 

By default, \medskip is defined to be 6pt plus 2pt minus 2pt. 

EXAMPLE 

This is the same table as in the \tablerule example, with extra vertical space added using 
\tableskip. 

\boxtable{\hsize}{#\hf ill k #\hfill \cr 

\hf ill\Bigstrut Advantages k \hfill Disadvantages \cr 

\tablerule 

Simple, fast k Does not enhance high frequency\cr 
\tableskip 

Requires little storage k Inaccurate regional values\cr 
\tableskip 

Popular k Inaccurate harmonic components \cr 
\tableskip 

Does not require complete data set &\cr 
\tableskip 

Accurate global mean &\cr} 


yields 


Advantages 

Disadvantages 

Simple, fast 

Does not enhance high frequency 

Requires little storage 

Inaccurate regional values 

Popular 

i 

Inaccurate harmonic components 

Docs not require* complete data set. 


' Accurate global mean 



RESTRICTIONS 

Using \tableskip in a table with vertical rules will result in a break (usually undesirable) in 
the vertical rules. 
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NAME 


tablerule — horizontal rule within a table 

SYNTAX 

\tablerule 

DESCRIPTION 

The \tablerule macro is to be used within a table to produce a horizontal rule, or line, all 
the way across the table. It may be inserted following any \cr within a table. 

The resulting rule has a thickness of 0.4 point. 

EXAMPLE 

\boxtable{\hsizeH#\hfill & Nvrule# & #\hfill \cr 

\hf ill\Bigstrut Advantages && \hfill Disadvantages \cr 

\tablerule 

Simple, fast && Does not enhance high frequency\cr 
Requires little storage && Inaccurate regional values\cr 
Popular && Inaccurate harmonic components \cr 
Does not require complete data set &\cr 
Accurate global mean A\cr> 


yields 


Advantages 

Disadvantages 

Simple, fast 
Requires little storage 
Popular 

Does not require complete data set 
Accurate global mean 

Does not enhance high frequency 
Inaccurate regional values 
Inaccurate harmonic components 
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NAME 


tableskip — medium vertical skip within a table 

SYNTAX 

\tableskip 

DESCRIPTION 

The \tableskip macro is used with alignments to produce a vertical space equivalent to a 
\medskip. It may be inserted following any \cr within a table. 

By default, \medskip is defined to be 6pt plus 2pt minus 2pt. 

EXAMPLE 

This is the same table as in the \tablerule example, with extra vertical space added using 
\tableskip. 

\boxtable{\h8izeM#\hfill ft #\hfill \cr 
\hfill\Bigstrut Advantages ft \hfill Disadvantages \cr 
\tablerule 

Simple, fast ft Does not enhance high frequency\cr 
\tableskip 

Requires little storage ft Inaccurate regional values\cr 
\tableskip 

Popular ft Inaccurate harmonic components \cr 
\tableskip 

Does not require complete data set ft\cr 
\tableskip 

Accurate global mean ft\cr> 


yields 


Advantages 

Disadvantages 

Simple, fast 

Does not enhance high frequency 

Requires little storage 

Inaccurate regional values 

| Popular 

i 

Inaccurate harmonic components 

Does not require complete data set 


Accurate global mean 



RESTRICTIONS 

Using \tableskip in a table with vertical rules will result in a break (usually undesirable) in 
the vertical rules. 
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SEE ALSO 
\tablerule 

\medskip, pp. 70-71, The T^Kbook (ref. 1) 


NAME 


widehead — allows headings wider than the contents of a column 
SYNTAX 

\widehead{/ieadzn</} 

DESCRIPTION 

Often in tables, a heading of a column is wider than the contents of the column. In these 
cases, if I£X is allowed to consider the width of the heading in determining the final width 
of the column, the resulting table will have more white space than is usually desired, and 
alignment of the column with the heading may be undesirable. The \widehead macro causes 
T^X to ignore the width of the specified heading or table entry when determining the column 
width and to center this heading or entry in the column. 

EXAMPLE 

This example shows a simple two-column table. One column heading uses the \widehead 
macro, and one does not. 

\boxtable{4in}{\hf ill#\hf ill k #\vrule k \hfill#\cr 
kk \widehead{Average temperature , > \cr 
Year kk deg\hfill\cr 
\tablerule 

1960 kk 35 \cr 

1961 kk 45 \cr 

$\vdots$ kk $\vdots$\hf ill \cr> 


yields 


Year 

Average temperature, 
deg 

1960 

35 

1961 

45 


Without \widehead. the table looks like this: 



Average temperature, 

Year 

deg 

1960 

35 

1961 

45 
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NAME 


boxhead generate multiline headings in tables 
SYNTAX 

\boxhead{\\{/ieading/me> . .] > 

DESCRIPTION 

The result of the \boxhead macro is a box with lines of a multiline heading stacked on 
top of each other and centered with respect to each other. Each line of the multiline heading 
is specified by il \\{headinglineY in the above syntax. The number of lines of a heading is 
restricted only by good taste. 

Applications for \boxhead are not restricted to table headings, but that has been the most 
popular usage. 

EXAMPLE 

\boxtable{3in}{\hf ill#\hf ill k \vrule# k \hfill#\cr 

\boxhead{\\{Temperature,}\\{deg» k \boxhead{\\{Time}\\{of }\\{Day» \cr> 

\tablerule 

35 kk 7:00 p.m.\cr 

49 kk 7:00 a.m.\cr 

$\vdots$ kk $\vdots$\cr> 


yields: 



Time 

Temperature, 

of 

deg 

Day 

35 

7:00 p.m. 

49 

7:00 a.m. 

i : 


RESTRICTIONS 

When the heading at the top of a table contains spanner rules (that is, horizontal rules that 
span some, but not all, columns), \boxhead does not work well. 
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NAME 


leaderfill fill line with leaders. . . 

SYNTAX 

Meaderfill 

DESCRIPTION 

The Meaderfill macro replicates a box 1 em wide with a period in its center. A series of 
such spaced periods are called leaders. This macro fills space in the same manner that \hfill 
does, except that leaders are produced in the desired space. 

It is easy to use (no arguments) and especially useful in tables, and for Contents pages. It 
is based on TfeX’s Meaders macro. 

EXAMPLE 

\line{Introduction Meaderfill Page 3} 
yields 

Introduction Page 3 


SEE ALSO 

Meaders, p. 223, The TEKbook (ref. 1) 
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NAME 


twodots- force two leader dots 
threedots force three leader dots 

SYNTAX 

\twodots 

\threedots 

DESCRIPTION 

These macros produce exactly two or three leader dots, respectively. They are useful when 
doing tables with leaders to ensure that at least some leaders appear on the longest line in a 
column. 

EXAMPLE 

\table{4in>{#\leaderf ill k \hfill# k \hfill#\cr 
\omit &\multispan2 Target diameter\cr 
\omit &\multispan2 \hrulefill\cr 

\omit\strut\hfill Parameter \hfill k 1 cm \hfill k \widehead{2 . 54 cm}\cr 
\tablerule 

Minimum energy, keV\threedots k 175.83 k 154.91\cr 
Maximum energy, keV\threedots k 230.76 k 263.40\cr 
Optimum, keV k 200.00 k 200.00\cr> 

yields 


Target diameter 

Parameter I cm 2.54 cm 

Minimum energy, keV . . . 175.83 154.91 

Maximum energy, keV . . . 230.75 263.40 

Optimum, keV 200.00 200.00 


RESTRICTIONS 

The dots produced with these macros do not line up vertically with dots produced by 
\leaderfill. Of course, instead of using these macros, the width of the column containing 
leaders may be specified in the preamble to the table: 


\table{4in}{\hbox to2in{#\leaderf ill} k \hfill# k \hfill#\cr 


to obtain 


Target diameter 

Parameter 1 cm 2.54 cm 

Minimum energy, keV . . . 175.83 154.91 

Maximum energy, keV . . 230.75 263.40 

Optimum, keV ...... 200.00 200.00 
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NAME 


1, ql, qql — leader table lines 


SYNTAX 

\1 leftside k rightside \cr 
\ql leftside k rightside \cr 
\qql leftside k rightside \cr 

DESCRIPTION 

The leader table macro \1 produces a line with the leftside argument left-justified, the 
rightside argument right-justified, and the space between filled with leaders (dots). The leftside 
and rightside arguments can be any text or \hbox. 

The leader table macros \ql and \qql are used in the same way as \1, but they produce a 
line with the leftside argument indented one quad (approximate width of a capital M) and two 
quads, respectively. 

Repeated lines using the \1, \ql, and \qql macros create a two-column leader table. Contents 
pages, Indexes, and other lists often use this format. 

EXAMPLE 

\leftline{Wing:> 

\ql Area, $S$, ft$~2$ k 9.795\cr 
\smallskip 

\ql Span, $b$, ft k 9.707\cr 
\smallskip 

\leftline{\quad Incidence, deg, at — > 

\smallskip 

\qql $\eta$ = 0.1881 k 4.04\cr 
\smallskip 

\qql $\eta$ = 0.3031 k 3.35\cr 
\medskip 

\1 Landing gear wheel diameter, in. k 3.780\cr 


yields 

Wing: 

Area, S, ft 2 9.795 

Span, b. ft 9.707 

Incidence, deg, at — 

77 = 0.1881 4.04 

77 = 0.3031 3.35 

Landing gear wheel diameter, in 3.780 
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NAME 


table — basic table macro 


SYNTAX 

\table{tablewidth}{tablebody > 


DESCRIPTION 

The \table macro is essentially T^X’s \halign macro with some added features. 

The tablewidth argument is the overall width of the table. Varying the value of this 
parameter provides control over the amount of white space that appears in the final table. 

The tablebody argument contains all of the alignment information just as would be specified 
to \halign: a preamble plus the contents of the table, with a \cr ending each line and 
ampersands (&) separating column entries. 

The additional features of the \table macro include the following: 

• The table will be centered horizontally on the page (or column, if using double-column 
output.) 

• Additional vertical space is added above and below the table to set it apart. 

• TfeX’s \tabskip parameter value is changed to allow “plenty” of room for stretching and 
shrinking. 

• A \strut is automatically included at the beginning of every preamble. 

• Spacing between rows (\interlineskip) is turned off. 

• A tilde (~) is defined to be a space the width of a digit. It can be used as a placeholder for 
lining up columns of numbers. 

• The macro \. is defined to be a space the width of a decimal point. This can also be useful 
for lining up columns of numbers. 


EXAMPLE 

Note the use of ~ and V in the last column to achieve proper alignment. 
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\table{5inK\hfill# ft \hfill# ft \hfill# ft \hfill# ft \hfill#\cr 
\tablerule 

ft $W$ , \hf ill ft $H$,\hfill ft $D$,\hfill ft $B$.\hfill\cr 

\widehead{Compartment> ft in.\hfill ft inAhfill ft inAhfill ft inAhfill\cr 
\tablerule 

1 ft 24.0 ft 26.0 ft 82.0 ft 0\."\cr 

2 ft 24.0 ft 24.6 ft 78.0 ft 1.5\cr 

3 ft 24.0 ft 22.6 ft 73.0 ft 3."\cr 

4 ft 24.0 ft 20.6 ft 68.0 ft 4.5\cr 

5 ft 24.0 ft 18.6 ft 63.0 ft 6."\cr 

6 ft 24.0 ft 16.6 ft 58.0 ft 7.5\cr 

7 ft 24.0 ft 14.6 ft 53.0 ft 9."\cr 

8 ft 24.0 ft 14.6 ft 53.0 ft 9.‘\cr 

8 ft 24.0 ft 13.6 ft 49.8 ft 10.5\cr 

9 ft 24.0 ft 12.7 ft 46.5 ft 12.‘\cr 

10 ft 24.0 ft 11.8 ft 43.2 ft 13.5\cr 

11 ft 24.0 ft 10.9 ft 39.9 ft 15. _ \cr 

12 ft 24.0 ft 10.0 ft 36.6 ft 16.5\cr 

13 ft 24.0 ft 9.1 ft 33.3 ft 18.'\cr 

14 ft 24.0 ft 8.2 ft 30.0 ft 19.5\cr 

\tablerule} 


results in 


Compartment 

w, 

in. 

H, 

in. 

D, 

in. 

B, 

in. 

i 

24.0 

26.0 

82.0 

0 

2 

24.0 

24.6 

78.0 

1.5 

3 

24.0 

22.6 

73.0 

3. 

4 

24.0 

20.6 

68.0 

4.5 

5 

24.0 

18.6 

63.0 

6. 

6 

24.0 

16.6 

58.0 

7.5 

7 

24.0 

14.6 

53.0 

9. 

8 

24.0 

14.6 

53.0 

9. 

8 

24.0 

13.6 

49.8 

10.5 

9 

24.0 

12.7 

46.5 

12. 

10 

24.0 

11.8 

43.2 

13.5 

11 

24.0 

10.9 

39.9 

15. 

12 

24.0 

10.0 

36.6 

16.5 

13 

24.0 

9.1 

33.3 

18. 

14 

24.0 

8.2 

30.0 

19.5 


SEE ALSO 

\halign references from The TfiXbook (ref. 1) 

\ruledtable 

\boxtable 

\hardboxtable 
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NAME 


boxtable — basic table enclosed in a box 


SYNTAX 

\boxtable{tablewidth.y{tableb >ody} 


DESCRIPTION 

This macro is provided to simplify tables that are enclosed with rules. It is the macro most 
commonly used in TEB to typeset tables in the NASA format, which specifies not only outside 
rules but also vertical rules between columns. 

It is used identically to the \table macro and provides all of the same features, but the 
resulting table is enclosed in a box. This has the advantage of preventing the user from having 
to specify additional columns and rows in a table for surrounding rules. 

The tablewidth argument still refers to the final overall width of the table, including the 
width of the rules. The tablebody argument refers to the entire body of the table, including the 
preamble. 


EXAMPLE 

Contrast the following example with the previous example of the \table macro. Again notice 
the use of “ and \. in the last column. 


\boxtable{5.25inM\hfill# b Xvrule# b \hfill# * \vrule# 
b Xhfill# b Xvrule# Sc Xhfill# Sc Xvrule# Sc \hfill#\cr 
ScSc $W$, Xhfill ScSc $H$, Xhfill ScSc $D$. Xhfill ScSc $B$,\hfill\cr 

\widehead{Compartment} ScSc in. Xhfill ScSc in. Xhfill ktc in. Xhfill bb in.XhfillXcr 
Xtablerule 

1 ScSc 24.0 ScSc 26.0 ScSc 82.0 bb 0\.~\cr 

2 bb 24.0 bb 24.6 bb 78.0 bb 1.5\cr 

3 bb 24.0 bb 22.6 bb 73.0 bb 3.*\cr 

4 bb 24.0 bb 20.6 bb 68.0 bb 4.5\cr 

5 bb 24.0 bb 18.6 bb 63.0 bb 6.~\cr 

6 bb 24.0 bb 16.6 bb 58.0 bb 7.5\cr 

7 bb 24.0 bb 14.6 bb 53.0 bb 9.~\cr 

8 bb 24.0 bb 14.6 bb 53.0 bb 9.~\cr 

8 bb 24.0 bb 13.6 bb 49.8 bb 10.5\cr 

9 bb 24.0 bb 12.7 bb 46.5 bb 12.“\cr 

10 bb 24.0 bb 11.8 bb 43.2 bb 13.5Xcr 

11 bb 24.0 bb 10.9 bb 39.9 bb 15.~\cr 

12 bb 24.0 bb 10.0 bb 36.6 bb 16.5\cr 

13 bb 24.0 bb 9.1 bb 33.3 bb 18.‘\cr 

14 bb 24.0 bb 8.2 bb 30.0 bb 19.5\cr> 


results in 
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Compartment 

W, 

in. 

H, 

in. 

D, 

in. 

B, 

in. 

i 

■ ' 1 ■ 

26.0 



2 


24.6 


1.5 

:* 

24.0 

22.6 

73.0 

3. 

4 

24.0 

20.6 

68.0 

4.5 

5 

24.0 

18.6 

63.0 

6. 

6 

24.0 

16.6 

58.0 

7.5 

7 

24.0 

14.6 

53.0 

9. 

8 

24.0 

14.6 

53.0 

9. 

8 

24.0 

13.6 

49.8 

10.5 

9 

24.0 

12.7 

46.5 

12. 

10 

24.0 

11.8 

43.2 

13.5 

11 

24.0 

10.9 

39.9 

15. 

12 

24.0 

10.0 

36.6 

16.5 

13 

24.0 

9.1 

33.3 

18. 

14 

24.0 

8.2 

30.0 

19.5 


SEE ALSO 
\table 



NAME 


ruledtable — table macro for more complex tables 


SYNTAX 

\rnledtable{tablewidth}{tablebody > 


DESCRIPTION 

This macro is provided to allow you more fine-tuning control over spacing around columns 
in the table. This control is necessary when the first column of the table is a vertical rule (and 
\boxtable is not appropriate). The macro \ruledtable is used in the same way as the \table 
macro and provides all of the same features, with one important difference. 

Some amount of \tabskip glue must be specified within the preamble for the table (using 
TfeX’s \tabskip parameter) because \tabskip is set to 0 point (no stretch or shrink) before 
the alignment begins. The \tabskip parameter specifies the amount of glue (space) that TjgX 
inserts between every column of a table, including before the first column and after the last 
colujnn. Setting \tabskip to 0 point in this manner effectively “turns off” spacing before the 
first column of your table. This is especially useful if the first column of your table contains 
only a vertical rule. 


EXAMPLE 

Nruledtable{5inHNtabskip.25in plus 6in minus. 25in Nvrule# k #\hfill k 
\vrule# k Nhfill# k Nvrule# k Nhfill# k Nvrule# k Nhfill# k 
Nvrule#NtabskipOptNcr 
Nomit kk Nmultispan7Nhrulef illNcr 

Nomit NstrutNtabskip.25in plus 6in minus. 25in k kk B.F.O. Nhfill kk 
SkinNhfill kk LensNhf ill&Ncr 
Ntablerule 

fcDose, rad kk 12.545 kk 54.649 kk 34.319&Ncr 

^Fraction of exposure limit kk 0.421 kk 0.692 kk 0.860&Ncr 

Ntablerule} 


results in 



B.F.O. 

Skin 

Lens 

Dose, rad 

Fraction of exposure limit 

12.545 

0.421 

54.649 

0.692 

34.319 

0.860 


The following example is admittedly complex, but Nruledtable is used in complex circum- 
stances. The Ntabskip parameter must be controlled in this case because of the spanner rules 
touching the outer edges of the table. 
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\ruledtable{5.5 inM\vrule#\tabskip4em plus 6in minus 4em k 
\hf ill#\hfill k \vrule# k \hfill# k \vrule# k 
\hf ill#\hfill k Xvrule# k \hfill# k \vrule#\tabskipOpt\cr 
\tablerule 

k\multispan3\hf ill 1915--1948\hf illXBigstrut kk 
\multispan3\hfill 1941— 1959\hfill k\cr 
\tablerule 

k\widehead{Fiscal year} kk \widehead<Thousands \$> kk 

\widehead<Fiscal year} kk \widehead{Millions \$} k\cr 
\tablerule 

k 1915 kk 5.0 kk 1941 kk 11.2 k\cr 
k 1916 kk 5.0 kk 1942 kk 19.9 k\cr 
k 1917 kk 87.5 kk 1943 kk 25.4 k\cr 
k 1918 kk 112.0 kk 1944 kk 38.4 k\cr 


k 1933 kk 920.0 kk 1959 kk 101.1 k\cr 
\omit kk kk \multispan5\hrulefill\cr 
k 1934 kk 953.6 kk Subtotal kk 1095.0 k\cr 
k 1935 kk 1255.7 kk kk k\cr 


k 1940 kk 4180.0 kk kk k\cr 
\multispan5\hrulefill kfc\cr 

kSubtotal\Bigstrut kk 24\thinspace 926.1 kk kk k\cr 
\tablerule 

k\multi8pan7 Total \Bigstrut\leaderfill 1.12 billion k\cr 
\tablerule} 


results in 
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1915 

1948 

1941 

1959 

Fiscal year 

Thousands S 

Fiscal year 

Millions S 

1915 

5.0 

1941 

11.2 

1916 

5.0 

1942 

19.9 

1917 

87.5 

1943 

25.4 

1918 

112.0 

1944 

38.4 

1919 

205.0 

1945 

40.9 

1920 

175.0 

1946 

24.0 

1921 

200.0 

1947 

30.7 

1922 

200.0 

1948 

43.4 

1923 

225.6 

1949 

48.6 

1924 

307.0 

1959 

128.0 

1925 

470.0 

1951 

63.1 

1926 

534.9 

1952 

69.0 

1927 

513.0 

1953 

66.3 

1928 

550.0 

1954 

62.4 

1929 

836.7 

1955 

55.9 

1930 

1300.0 

1956 

72.7 

1931 

1321.0 

1957 

76.7 

1932 

1051.0 

1958 

117.3 

1933 

920.0 

1959 

101.1 

1934 

953.6 

Subtotal 

1095.0 

1935 

1255.7 



1936 

2543.8 



1937 

1630.5 



1938 

1280.8 



1939 

4063.9 



1940 

4180.0 



Subtotal 

24 926.1 



Total . . . . 



. 1.12 billion 


RESTRICTIONS 

It is advisable to use the \table and \boxtable macros also provided in LARCMACS until a 
need for this additional control arises. Problems with rules not meeting could be one indication. 
It would also be good to review references to \tabskip in The IfiXbook before experimenting 
with this macro. 

SEE ALSO 
\table 
\boxtable 
\hardboxtable 

\tabskip references from The T^Kbook (ref. 1) 
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NAME 


hardboxtable more complex table enclosed in a box 


SYNTAX 

\hardboxtable {tablewidth}{tablebody} 


DESCRIPTION 

This macro combines the features of \ruledtable and \boxtable. Perhaps it would have been 
more aptly named “ruledboxtable” ? It is used like \ruledtable (\tabskip must be specified), 
but the resulting table is enclosed in a box. See \ruledtable for more information. 


EXAMPLE 

The following is the same as the previous example under \ruledtable, but the \vrules and 
\tablerules previously used to specify the box around the table are no longer necessary: 


\hardboxtable{5.5 inM\tabskip4em plus 6in minus 4em# ft 
\hfill#\hfill ft \vrule# ft \hfill# ft \vrule# ft 
\hfill#\hfill ft \vrule# ft \hfill# ft \tabskipOpt#\cr 
&\multispan3\hfill 1915--1948\hf ill\Bigstrut ftft 
\multispan3\hfill 1941— 1959\hf ill ft\cr 
\tablerule 

&\widehead{Fiscal year} ftft \widehead{Thousands \$> ftft 

\widehead{Fiscal year} ftft \widehead{Millions \$} ft\cr 
\tablerule 

ft 1915 ftft 5.0 ftft 1941 ftft 11.2 t\cr 
ft 1916 ftft 5.0 ftft 1942 ftft 19.9 ft\cr 
ft 1917 ftft 87.5 ft* 1943 ftft 25.4 ft\cr 
ft 1918 ftft 112.0 ftft 1944 ftft 38.4 ft\cr 


ft 1933 ftft 920.0 ftft 1959 ftft 101.1 ft\cr 
\omit ftft ftft \multispan5\hrulefill\cr 
ft 1934 ftft 953.6 ftft Subtotal ftft 1095.0 ft\cr 


ft 1940 ftft 4180.0 ftft ftft ft\cr 
\multispan5\hrulefill &&\cr 

ftSubtotal\Bigstrut ftft 24\thinspace 926.1 ftft ftft &\cr 
\tablerule 

ft\multispan7 Total \Bigstrut\leaderf ill 1.12 billion ft\cr} 


results in 
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1915 

-1948 

1941- 

1959 

Fiscal year 

Thousands $ 

Fiscal year 

Millions 1 

1915 

5.0 

1941 

11.2 

1916 

5.0 

1942 

19.9 

1917 

87.5 

1943 

25.4 

1918 

112.0 

1944 

38.4 

1919 

205.0 

1945 

40.9 

1920 

175.0 

1946 

24.0 

1921 

200.0 

1947 

30.7 

1922 

200.0 

1948 

43.4 

1923 

225.6 

1949 

48.6 

1924 

307.0 

1959 

128.0 

1925 

470.0 

1951 

63.1 

1926 

534.9 

1952 

69.0 

1927 

513.0 

1953 

66.3 

1928 

550.0 

1954 

62.4 

1929 

836.7 

1955 

55.9 

1930 

1300.0 

1956 

72.7 

1931 

1321.0 

1957 

76.7 

1932 

1051.0 

1958 

117.3 

1933 

920.0 

1959 

101.1 

1934 

953.6 

Subtotal 

1095.0 

1935 

1255.7 



1936 

2543.8 



1937 

1630.5 



1938 

1280.8 



1939 

4063.9 



1940 

4180.0 



Subtotal 

24926.1 



Total . . . . 




1.12 billion 


For another example, look at the file cosati.tex in appendix A. The macro \hardboxtable 
is used to produce the RDP (abstract) page in NASA reports. 

RESTRICTIONS 

Like \ruledtable, \hardboxtable should be reserved for difficult alignments where problems 
have surfaced in using \table or \boxtable. 

SEE ALSO 
\table 
\boxtable 
\ruledtable 
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NAME 


symboltable — standard format for symbol lists in NASA reports 


SYNTAX 

\aymboltafole{colmdth}{tablecontents} 


DESCRIPTION 

Almost every NASA technical report contains a “Symbols” section including a table defining 
the symbols used in the report. In addition, short lists defining symbols after a particular 
equation are common throughout a report. The format for these tables is almost always two 
left-aligned columns. The first column is a narrow one containing the symbol and the second 
column is much wider for the definition. In addition, the definition for any single symbol may 
extend beyond one line of the table. 

The colwidth argument is used to specify the desired width of the second column. The 
overall width of the table is defined to be \hsize. 

The tablecontents argument is actually the body of the symbol table. It may contain as 
many lines as desired of the following form: 

symbol k definition \cr 

where symbol is the symbol for the left column, enclosed in dollar signs ($. . .$) where 
appropriate, and definition is the text that defines the symbol. The text definition will be 
broken into as many lines as necessary. 


EXAMPLE 

In the following example, \hsize has been temporarily set to 20 picas. 

\symboltable{14pc}{ 

$b$ k wing spam, m (ft)\cr 
\tableskip 

$C_m$ k pitching-moment coefficient, $M_Y/qS_b$\cr 
\tableskip 

$M_Y$ k pitching moment, N-m (ft-lb)\cr 
\tableskip 

SPL k sound pressure level\cr 

\tableskip 

Subscripts :&\cr 

\tableskip 

$L$ k left wing\cr 

\tableskip 

max k maximum\cr> 


results in 
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b wing span, m (ft) 

C m pitching-moment coefficient, 

My /qS b 

My pitching moment, N-m (ft-lb) 

SPL sound pressure level 

Subscripts: 


L left wing 

max maximum 


(See also appendix B, p. 110.) 

SEE ALSO 

\indentsymtab 

\SYMBOLTABLE 
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NAME 


indent symtab — indented version of symboltable 
SYNTAX 

\ indent sy mt ab{ colwidth } { tablecontents } 

DESCRIPTION 

This macro is identical to \symboltable except that the entire resulting table is indented 
1.5 ems on the left. For narrower tables and tables appearing in the text of a report, this may 
produce a better appearance. 

As in \symboltabIe, colwidth is the width of the second column, and tablecontents is actually 
the body of the table. See \symboltable for more information. 

EXAMPLE 

In the following example, \hsize has been temporarily set to 20 picas. 

\indentsymtab{14pc}{ 

$b$ k wing span, m (ft)\cr 
\tableskip 

$C_m$ k pitching-moment coefficient, $M_Y/qS_b$\cr 
\tableskip 

$M_Y$ k pitching moment, N-m (ft-lb)\cr 
\tableskip 

SPL k sound pressure level\cr 

\tableskip 

Subscripts :&\cr 

\tableskip 

$L$ k left wing\cr 

\tableskip 

max k maximum\cr> 

results in 


b 

wing span, m (ft) 

Cm 

pitching-moment coefficient, 
My/qS b 

My 

pitching moment, N-m (ft-lb) 

SPL 

sound pressure level 

Subscripts 


L 

left wing 

max 

maximum 


(See also appendix B. p. 111.) 
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SEE ALSO 
\symboltable 
' \SYMBOLTABLE 



NAME 


SYMBOLTABLE — three-column version of symboltable 


SYNTAX 

\SYy[BOLTXBLEicolwidthy{tablecontentsy 


DESCRIPTION 

This macro is identical to \symboltable, except that it provides an extra column for symbols. 
It is useful in instances where two different sets of symbols must be used. For example, a variable 
may be represented by one symbol in the report and a different symbol in a computer listing. 

As in \symboltable, colwidth is the width of the column containing definitions, and 
tablecontents is the body of the table. The tablecontents argument consists of lines of the 
form 


symbol k symbol k definition \cr 


See \symboltable for more information. 


EXAMPLE 

In the following example, \hsize has been temporarily set to 20 picas. 


\SYMB0LTABLE{ lOpc }{ 

$b$ k B k wing span, m (ft)\cr 
\tableskip 

$C_m$ & CM & pitching-moment coefficient, $M_Y/qS_b$\cr 
\tableskip 

$M_Y$ k MY k pitching moment, N-m (ft-lb)\cr 
\tableskip 

SPL kk sound pressure level\cr 

\tableskip 

Subscripts :&\cr 

\tableskip 

$L$ && left wing\cr 

\tableskip 

max kk maximum\cr> 


results in 
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b 

B 

wing span, m (ft) 

Cm 

CM 

pitching-moment coeffi- 
cient, My/qSfy 

My 

MY 

pitching moment, N-m 
(ft-lb) 

SPL 

Subscripts: 


sound pressure level 

L 


left wing 

max 

SEE ALSO 


maximum 


\symboltable 

\indentsymtab 
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Math Macros 


The ease with which mathematics can be typeset with TgX is its greatest advantage. The 
macros in this section slightly fine-tune TfeX’s math capability: 

• Font size macros for use within displayed equations can be used without affecting the 
surrounding text. 

• The displayed math macros \Eqalign, \Eqaligncondno, and \Eqno customize TfeX’s dis- 
played math macros for NASA format. 

• The macro \bmatrix complements T^jX’s other matrix macros to produce matrices with 
square brackets. Partitioned matrices can be typeset with the macros \vdashes, \dashfill, 
\twodashes, and \threedashes. 

• The macro \bmit complements Plain TfeX’s \bf macro, in order to obtain lowercase Greek 
characters in boldface type. 

• Struts for use not only in math but also in text and tables are based on TfeX’s big, Big, 
bigg, and Bigg delimiter sizes. 

• Macros to produce hyphens in math and small slanted fractions in text are also available. 
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NAME 


math font size macros — macros to change type size of displayed equation 


SYNTAX 

\eightptmath 

\xiineptmath 

\tenptmath 

DESCRIPTION 

Sometimes it is desirable to change the type size of a particular displayed equation. For 
example, if an equation is particularly large or wide, it may fit better within the column, or 
simply look better, in a smaller type size. 

These math font size macros change the size of the fonts for the duration of the equation 
with no effects on surrounding text. The \baselineskip also remains unchanged. 

To use these macros, simply insert one of them after the $$ at the beginning of the equation. 


EXAMPLE 

$$ 

\eightptmath 

\eqalign{D_2(T) 

*=\left\{ 

•Ce*{ [(\lambda_l+\lambda_2+\lambda_3) “2-4\lambda _i\lambda_2] *<l/2>T/2> 
\over-(\lambda_l+\lambda_2+\lambda_3) 

[(\lambda_l+\lambda_2+\lambda_3) “2-4\lambda_l\lambda_2] ‘{1/2} 

+ (\lambda_l+\lambda_2+\lainbda_3) "2-4\lainbda_l\lainbda_2}\right; .\cr 
&\quad -\left. 

{e~{- [(\lambda_l+\lambda_2+\Iambda_3)‘2-4\lambda _l\lambda_2] “{l/2}T/2> 
\over- (\lambda_l+\larabda_2+\lambda_3) 

[(\lambda_l+\lambda_2+\lambda_3)*2-4\lambda_l\lambda_2] “{1/2} 
+(\lambda_l+\lajnbda_2+\lambda_3)*2-4\lambda_l\lambda_2}\right\} 
2\latnbda_l\lambda_2e*{- (\lambda_l+\lambda_2+\lambda_3)T/2}\cr} 

$$ 


results in 


D 2 (T) = 


e !(Ai+A2+A3) 2 -4A l A 2 J 1 /2 r /2 

-(A x A 2 4 - A 3 )[(A] + A 2 + A3) 2 - 4 Aj A2I 1 / 2 + (Aj + A 2 + A3) 2 - 4 Aj A 2 
e~ 1(Ai+A 2 +A3) 2 — 4A[ A 2 ) 1 ^ 2 T/2 

-(Ai + A 2 + A 3 )[(Ai + A 2 + A3) 2 - 4AJA2] 1 / 2 + (Aj f A 2 + A3) 2 - 4 AjA 2 


2 Aj A 2 e - f^ +A 2 +A 3 )T/2 


which is still too wide! 
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RESTRICTIONS 


These math font size macros must be used in math mode. 
SEE ALSO 

font size macros — \eightpt, \ninept, \tenpt 
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NAME 


Eqno — variation of eqno, to produce 10-point roman (non-math) equation number 
SYNTAX 

\Eqno ( equationnumber) 

DESCRIPTION 

\Eqno is a variation of \eqno from Plain TgX that processes the equationnumber in 
horizontal mode (like text) rather than in math mode. The equationnumber will be treated 
like text, and will be output in 10-point roman font. 

Note the parentheses ( ) in the syntax as opposed to the usual curly braces that surround 
arguments. The parentheses are used to emphasize the fact that parentheses will appear 
around the equation number in the output. 

To prevent the type size of the equation number from being affected, This macro should 
be used whenever the type size of the displayed equation is adjusted. Also, using \Eqno will 
ensure that any letter designations in equation numbers will be in roman (text) type. 

EXAMPLE 

$$ 

Ax + By + C * 0 \Eqno(2a) 

$$ 

yields 


Ax + By + C — 0 


(2a) 


Also 

$$ 

\ eight ptmath 
\eqalign{D_2(T) 

A=\left\{ 

■Ce*< C (\lambda_l+\lambda_2+\lambda_3) *2-4\lambda _l\lambda_2] '{l/2}T/2} 
\over-(\laobda_l+\lambda_2+\lambda_3) 

C(\lambda_l+\lambda_2+\lambda_3) *2-4\lambda_l\lambda_2] '{1/2} 

+ (\lambda_l+\lambda_2+\lainbda_3) '2-4\laabda_l\lambda_2}\right . \cr 
4\quad -\left. 

{e"{- [(\lambda_l+\lambda_2+\lambda_3) *2-4\lambda _l\lambda_2] *{l/2}T/2> 
\over- (\lajnbda_l+\lambda_2 + \lambda_3) 

[(\lambda_l+\lambda_2+\lambda_3) *2-4\lambda_l\lambda_2] '{1/2} 

+ (Mambda_l+\lambda_2+\lambda_3)'2-4\lainbda_l\lambda_2}\right\}\cr 
&\quad \times2\laabda_l\lanbda_2e'{-(\lambda.l+\lambda_2+\lambda_3)T/2}\cr} 
\Eqno(A2) 

$$ 
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yields 


ihcn 


[ e l(*i+*a-tA:i)'' t -«A|Aal l/3 772 

( - (A) + A 2 + A 3 )|(A, + A 2 + A 3) 2 - 4 AiA 2 l*/ a + (Aj + A 2 + A 3 )* - 4A ( A a 

g-ICAt+Aa+Aa^-^Aa ] 1 /J r/2 

-(^1 + A 2 + A 3 )[(Aj + Aj + A 3 )2 - 4A 1 Aj] 1 /a + (\ x + A 2 + A 3 )2 - 4A,A 2 
x 2A 1 A 2 e - ( A « +A »+ A 3)7'/2 


(A2) 


SEE ALSO 

\eqno, pp. 186-187, The TfiXbook (ref. 1) 
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NAME 


Eqalignno - version of eqalignno with 10-point roman equation number 
SYNTAX 

\Eqa.llgnno{alignedmath} 

DESCRIPTION 

\Eqalignno is a variation of TfeX’s \eqalignno. It is used identically to \eqalignno. Please 
refer to The TgKbook (ref. 1) for details about \eqalignno. 

The only difference is that the equation number is ensured to be in the 10- point roman font. 
To prevent the type size of the equation number from being affected, this macro should be used 
whenever the type size of the displayed equation is adjusted. The equation number is assumed 
to be horizontal mode material (roman type), not math mode (italic type). 

EXAMPLE 

$$ 

\eightptmath 

\Eqalignno{D_2(T) 

&=\left\{ 

{e~{ [(\lajnbda_l+\lambda_2+\lambda_3) ~2-4\larabda _l\lambda_2] ~{l/2}T/2} 
\over-(\lambda_l+\lambda_2+\lambda_3) 

[(\lambda_l+\lambda_2+\lambda_3) ~2-4\lambda_l\lambda_2] *{1/2} 

+ (\lambda_l+\lambda_2+\lambda_3) ~2-4\lambda_l\lambda_2}\right . \cr 
<fe\quad -\left. 

{e~{- [(\lambda_l+\lambda_2+\lambda_3)*2-4\lambda _l\lambda - 2] ~{l/2}T/2} 
\over- (\lambda_l+\lambda_2+\lambda_3) 

[ (\lambda_l Alambda_2+\lambda_3) *2-4\lambda_l\lambda_2] *{1/2} 

+ (\lambda_l+\lajnbda_2+\lambda_3) * 2 -4\ lambda. l\lambda_2}\right\}\cr 
&\quad\times2\lambda_l\lambda_2e*{- (\lambda_l+\lambda_2+\lambda_3)T/2} 

&(A2) \cr} 

$$ 


yields 


c [(Ai + A2 + A; } ) 2 -4 Aj \i\ l l 2 T/2 

— (Ai + *2 + A 3 )[(Aj + A 2 + A3) 2 - 4 A ! A 2 ] 1 / 2 + (Aj + A2 + A3) 2 - 4 AjA 2 
e “[(Ai+A2-fA3) 2 -4A 1 A2] 1//2 r/2 

— (Ai + A2 + A 3 ) ( ( A 2 t A2 r A3) 2 - 4 A 1 A2 ) 1 /^ + (Aj + A2 4 - A3) 2 - 4AjA2 

x 2 A 1 A 2 €~( Al+A 2 +‘ A 3 )r/ 2 (A2) 



SEE ALSO 

\eqalignno, pp, 192 193, The 7)<]X book (ref. 1) 
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NAME 


Eqaligncondno — variation of \Eqalignno, right-justified “condition” before equation number 


SYNTAX 

\Eqal ignc ondno { alignedmath > 

DESCRIPTION 

This macro is similar to \Eqalignno in that the equation number appears in 10-point roman 
type. The important distinction of \Eqaligncondno is that a third part of each expression 
can be aligned on the right before the equation number. This makes Eqaligncondno ideal for 
constructions with “conditions” (hence the name!) 

EXAMPLE 

$$ 

\Eqaligncondno{f (x) *= 0 ft \hbox{if > (x * 0) ft (2a)\cr 

f(x) ft= <l\over x> ft \hbox{(if > x > 0) ft (2b)\cr 
f(x) ft= \infty ft \hbox{ (Otherwise)} ft (2c)\cr> 


$$ 




yields 


/(*)» 0 

if x = 0 

(2a) 


-» 1 H 
1! 

if x > 0 

(2b) 


f(x) = 00 

Otherwise 

(2c) 


SEE ALSO 
\Eqalignno 

\eqalignno. pp. 192-193, The TfiXbook (ref. 1) 
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NAME 


bmatrix — matrix with square brackets 
SYNTAX 

\bmatrix{ malrixcontents } 

DESCRIPTION 

The \bmatrix command uses T^X's \matrix macro to produce a matrix from matrixcontents 
and encloses the matrix in square brackets ([ ]). It is analogous to Plain T^X’s \pmatrix macro. 

The matrixcontents argument contains all the entries for the matrix. Column entries should 
be separated with ampersands (&), and \cr should be used to designate the end of each row. 

EXAMPLE 

$$ 

\bmatrix{ 1 & 2 tc 3 \cr 
4 & 5 & 6 \cr 
7 ft 8 & 9 \cr> 

$$ 

yields: 

1 2 3 
4 5 6 

7 8 9 

SEE ALSO 

\matrix, \pmatrix references in The T^pCbook (ref. 1) 
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NAME 


vdashes — vertical dashes for partitioned matrices 

SYNTAX 

\vdashes 

DESCRIPTION 

The \vdashes macro works similarly to I^X’s \vdots macro for matrices. It is useful for 
generating vertical dashed lines in partitioned matrices. 

EXAMPLE 

$$ 

\bmatrix<K_{ll> ft \vdashes ft K_{13> ft \ vdashes ft K_{lB>\cr 

K_{21> ft \vdashea ft K_{33> ft \ vdashes ft K_{36>\cr 

K_<51> ft \vdashes ft K_{B3> ft \vdaahes ft K_{66}\cr> 

$$ 

yields 


*n 

1 

1 

*13 

1 

1 

*15 

*21 

1 

1 

1 

*33 

1 

1 

1 

*35 

*51 

1 

1 

1 

*53 

1 

1 

1 

*55 


SEE ALSO 

\vdots, p. 177, The TgKbook (ref. 1) 
\twodashes. \threedashes, \dashfill 
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NAME 


dashfill — fill space with horizontal dashes 

SYNTAX 

\dashfill 

DESCRIPTION 

The \dashfill macro fills space in the same manner that \hfill does, except that dashes are 
produced in the desired space. This macro was developed for partitioned matrices. 

EXAMPLE 

$$ 

\bmatrix{K_{ll> ft \vdashes ft K_{13> ft \vdashes ft K_{15}\cr 
\multispan5\dashfill\cr 

ft Xvdashes ft K_{33> ft \vdashes ft K_{35}\cr 
ft\multispan4\dashfill\cr 

\multispan3Symmetric\hfill ft \vdashes ft K_{65>\cr> 

$$ 

results in 

#11 | #13 j #15 

j #33 | #35 

Symmetric j K 55 

SEE ALSO 

\vdashes, \twodashes, \threedashes 
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NAME 

twodashes, threedashes — horizontal dashes for partitioned matrices 

SYNTAX 
\twodashes 
\ threedashes 

DESCRIPTION 

These macros produce either two or three short consecutive horizontal dashes for use in 
partitioned matrices. They can be used similarly to \cdots or \ldots in Plain TfeX. They are 
especially useful in partitioned matrices when \dashfill produces only one dash. Use the two- 
or three-dash version depending on your preference in your application. 

EXAMPLE 

$$ 

\bmatrix{w_l\cr \twodashes\cr w_2\cr \twodashes\cr w_3\cr} 

\bmatrix{w_l\cr \threedashes\cr w_2\cr \threedashes\cr w_3\cr> 

\bmatrix{w_l\cr \dashfill\cr w_2\cr \dashfill\cr w_3\cr> 

$$ 

results in 


“ Wi ' 


‘ m ‘ 


'U>1 ' 

W 2 

= 

W2 

= 

v>2 

- - 


. m - 


-W3- 


SEE ALSO 

\cdots, \ldots. p. 172, The T^Xbook (ref. 1) 
\dashfill, \vdashes 
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NAME 


bmit — lowercase Greek in boldface font 


SYNTAX 

\bmit 

DESCRIPTION 

Vectors, matrices, and tensors are usually represented by boldface characters. Roman letters 
and capital Greek letters can be obtained in math mode with Plain TkjX’s \bf macro. However, 
lowercase Greek letters are a different matter. In LARCMACS the lowercase Greek letters have 
been defined as in Exercise 17.20 of the The T^jXbook (ref. 1) and \bmit causes lowercase Greek 
to be boldface. 

The macro \bmit should be used like \rm, \it, and \bf and enclosed in braces to avoid 
unwanted font changes elsewhere in the equation. 

Please note that \bf is used to obtain capital Greek and \bmit is used to obtain lowercase 
Greek. 


EXAMPLE 


$$ 

\tilde{\bmit\xi> 

=\lef t\{\matrix{\tilde{\bmit\xi} ’ \cr 


{\bf \Gamma} ’ \cr>\right\> 
=\lef t\{\matrix'(\tilde'{\bmit\xi}’ ’ \cr 


$$ 


{\bf T>_A<\bmit\delta> ’_c\cr>\right\> 


results in 



RESTRICTIONS 

Not all installations of am fonts have a bold math italic font. 

If you were to type a lowercase Greek letter under the effect of \rm or \bf, you would get 
a spurious character: for example, $-(\«n\alpha}$ would result in ff. 

SEE ALSO 

Exercise 17.20 in The TgKbook (ref. 1) 
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NAME 


bigstrut, Bigstrut, biggstrut, Biggstrut — struts to adjust vertical spacing 
SYNTAX 

\bigstrut, \Bigstrut, \biggstrut, \Biggstrut 
DESCRIPTION 

Struts are useful for adjusting vertical spacing in math constructions and in tables. These 
struts have height and depth, but no width, and thus do not result in any visible output. A 
\bigstrut has the height plus depth of a \big(. A \Bigstrut has the height plus depth of a 
\Big(. A \biggstrut has the height plus depth of a \bigg(. And, a \Biggstrut has the height 
plus depth of a \Bigg(. 

EXAMPLE 

$$ 

\left\{\Bigg8trut\left\{\biggstrut\left\<\Bigstrut\l«ft\{\bigstrut 

\right\>\right\>\right\>\right\> 

$$ 

yields 


{{(»}}) 

Another more practical example, but not as much fun, is 

$$ 

p=\cases{\displaystyle 

-{p_o\beta\over\pi}-\sunT{10}_{n=l}p_n\cos nYtheta 
ft\hf ill$ (-0 . 2<\xi<0 . 2) $\cr 
\Biggstrut 6.895\timesl0~5 

&\hf ill$(\ vert \xi\ vert >0.2) $\cr}\eqno{ (27)} 


which results in 


P = 


a 10 

— — ^2 Pn cos n0 (-0.2 < £ < 0.2) 

n=l 


6.895 x 10 5 


m > o.2) 


Without the \Biggstrut, the spacing in this equation is unbalanced: 

a 10 

PoP a 

> p n COS 710 

71* , 

n= 1 

6.895 x 10 5 


P = 


(27) 


62 


(- 0.2 < £ < 0 . 2 ) 
(lei >0.2) 


(27) 


For other examples of using these struts, see the examples in the “Table Macros” section. 
SEE ALSO 

\strut and \mathstrut references in The TgXbook (ref. 1) 
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NAME 


hyphen — produce hyphen in math mode 

SYNTAX 

\hyphen 

DESCRIPTION 

In math mode, the hyphen character (-) produces a minus sign. The macro \hyphen 
produces a normal 10-point hyphen, even in math mode. It is useful in instances in math 
mode when a hyphen is desired rather than a minus sign. 

EXAMPLE 

Compare ${\rm Lift-curve\ slope>»\partial C_L/\partial\alpha$ with 
${\rm Lift\hyphen curve\ slope}*\partial C_L/\partial\alpha$ 

yields 

Compare Lift - curve slope = dCjJda with Lift-curve slope = dCi/da 
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NAME 

smallhyphen — produce small-sized hyphen in math mode 

SYNTAX 

\smallhyphen 

DESCRIPTION 

This macro produces a small (7-point) hyphen. It is useful for hyphens that appear in 
superscripts or subscripts. 

EXAMPLE 

Compare ${\rm SPL_{structure-borne»$ with 
${\rm SPL_{structure\smallhyphen bome»$ 

yields 

Compare SPL s t rU cture— borne with SPL s t ruc ture-borne 
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NAME 


slant— small, slashed, in-line fraction 
SYNTAX 

\slant{numeratorMdenomm ator} 

DESCRIPTION 

Fractions within the text can be produced with the slash character (1 2/3) or with Plain 
T^X/s \over macro (1 1). Typographers have traditionally used small fractions (1%). The 
\slant macro produces a small, slashed fraction within text. 

Do not enclose \slant in dollar signs ($. . .$). 

EXAMPLE 

The first two sentences under DESCRIPTION were produced by the following: 

Fractions within the text can be produced with the slash character 
(1 2/3) or with Plain \TeX’s Wover macro (l${2\over3>$) . Typographers 
have traditionally used small fractions (l\slant{2>{3>) . 


SEE ALSO 

fractions, pp. 139-141, The T^Xbook(ref. 1) 
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Miscellaneous Macros 

This section contains macros for a variety of purposes: 

• Macros to draw boxes around things. 

• Macros to produce special characters such as degree signs, ellipses, and trademark symbols. 

• A macro to produce a large font. 

• A macro to control vertical spacing more precisely. 
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NAME 

boxit — draw a box around something, including some surrounding spacing 

SYNTAX 

\boxit{<ex(> 

DESCRIPTION 

The \boxit macro is similar to one from Exercise 21.3 in The T^book. The given text is 
surrounded an all four sides by 3 points of space and ruled lines. 

The text argument can be almost any text or box. It will be processed in restricted horizont al 
mode. 

EXAMPLE 

\boxit{\TeX> 

yields 


RESTRICTIONS 

The resulting box does not have the same baseline as the original text. 
SEE ALSO 

Exercise 21.3, pp. 223 and 331, The T^Xbook (ref. 1) 

\boxittable 
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NAME 


boxittable — draw a box that exactly fits around something 
SYNTAX 

\boxittable{ text} 

DESCRIPTION 

The \boxittable macro is similar to the \boxit macro. The given text is surrounded by 
ruled lines on all four sides. 

This macro is useful for ruled tables where no extra space around the perimeter is desired. 
In fact, it is used in the definition of \boxtable and \hardboxtable. 

The text argument can be either text or a box (containing an entire table, for example). It 
will be enclosed in an \hbox. 

EXAMPLE 

\boxittable{\hbox{\TeX» 

yields 

m 


RESTRICTIONS 

The resulting box does not have the same baseline as the original text. 

SEE ALSO 
\boxit 
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NAME 


deg — degree symbol for text (horizontal mode) 

SYNTAX 

\deg 

DESCRIPTION 

For use in text, outside of math mode, \deg is a simple way to produce a small superscripted 
circle, or degree symbol. 

EXAMPLE 

The temperature rose 10\deg\ when heat was applied. 

yields 

The temperature rose 10 ' when heat was applied. 

RESTRICTIONS 

This macro overrides the \deg macro from Plain T£X. 

Attempts to use this macro within math mode will yield unusual characters. 

SEE ALSO 

\deg, p. 162, The T^Xbook (ref. 1) 
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NAME 

ellipse — produce an ellipse (. . .) 

SYNTAX 

\ellipse 

DESCRIPTION 

In Plain T£X, it is necessary to go into math mode to produce an ellipse properly. This 
macro is provided to easily produce an ellipse within text, or horizontal mode. 

EXAMPLE 

Hnmun \ellipse\ I wonder why? 
yields 

Hmmm ... I wonder why? 

SEE ALSO 

\ldots, p. 73, The 7 "feXbook (ref. 1) 
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NAME 


solidmedskip variation of \medskip with stretching prevented 


SYNTAX 

\solidmedskip 

DESCRIPTION 

Plain IfeX s \medskip macro is defined to be a vertical skip of 6 points that is allowed to 
stretch or shrink by 2 points. 

Occasionally, it is preferable to have more control over the amount of vertical space used in 
certain places. The \solidmedskip macro provides an (almost) fixed amount of vertical space 
the same size as a \medskip. A \solidmedskip is not allowed to stretch and is only allowed to 
shrink an unnoticeable amount (I point). 

EXAMPLE 

\line{\vbox to 32pt{\hbox{There is a medskip} 

\medskip 

\hbox{between these lines}} 

Nhskip. Sin 

\vbox to 32pt{\hbox{There is a solidmedskip} 

\solidmedskip 

\hbox{between these lines}} 

\hf ill} 


yields 

There is a medskip 
between these lines 


There is a solidmedskip 
between these lines 


While T]eX is running, we receive the following messages concerning the left and right “vboxes,” 
respectively: 


Underfull \vbox (badness 2318) detected at line 6 
Underfull \vbox (badness 10000) detected at line 9 


The badness is much worse (the worst it could be) for the right vbox because the \soiidmedskip 
does not stretch vertically. 
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NAME 

tlfont — large font for miscellaneous titles 

SYNTAX 

\tlfont 

DESCRIPTION 

This macro changes the current font to a large roman font (\magstep 2, approximately 14 
points). The macro \tlfont is not intended for use within NASA formal reports, but may have 
other applications. 

EXAMPLE 

\tlfont This is a title! 
yields 

This is a title! 

RESTRICTIONS 

This macro is not set up to work with the \contents macro. 
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NAME 


trademark — trademark symbol 


SYNTAX 

\trademark 

DESCRIPTION 

This macro produces a small superscripted R enclosed in a circle, known as a “trademark” 

symbol. 

EXAMPLE 


\TeX\trademark\ is a trademark of the American Mathematical Society. 


yields 

T£X® is a trademark of the American Mathematical Society. 
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Appendix A 

LARCMACS Definitions 

The following is the actual code for the complete set of LARCMACS macros. For consistency 
please do not edit any of the LARCMACS files. If changes are desired, macros may be redefined 
and parameter values reset in your own macro files or document files. 

We do encourage you to study these definitions and use the ideas applied in these macros 
in your own macro definitions. 


7, 

7. This is LARCMACS . TEX as of February 1988 

7. This is the generic version of MACROS.TEX used by TEB at LaRC. 

7. (Written by Linda Woessner and Mary McCaskill) 

% 

*/, For quest ions /problems, contact: 

7, Cheryl Williams (x2561) or Mary McCaskill (x3325) 

7. 

7. 

7. MI SC. MACROS 

7. 

7. Boxit macro as per ex 21.3 in TeXbook 

\def\boxit#l{\vbox{\hrule\hbox{\vrule\kern3pt 

\vbox{\kern3pt\hbox{#l>\kern3pt}\kern3pt\vrule}\hrule» 

7, 

7. Boxit macro without 3pt spacing 

\def\boxittable#l{\vbox{\hrule\hbox{\vrule\vbox{#l}\vrule}\hrule}} 

7. 

7, Leader macros 

\def\leaderf ill{\leaders\hbox to lem{\hss . \hss>\hfill> %fill line 
\def\twodots{\hbox to 2em{\leaderfill» 7.f orce two leaders 

\def \threedots{\hbox to 3em{\leaderfill» 7.force three leaders 

7. 

7. Non- Math Degree symbol 
\def \deg{\char ’027} 

7. 

7. Flush left version of \item (for reference lists) 
\def\leftitem#l{\par\noindent\rlap{#l>7. 

\hskip\the\parindent\hang} 

7. 

7. Alternate definition for backslash character (\\) 

7.\def \\{$\backslash$) 

7. 

7, 
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*/. TABLE MACROS 

•/. 

’/, For use within tables... 

\def\tablerule{\noalign{\hrule» %hrule within a table 

\def\widehead#l{\omit\strut\hidewidth#l\hidewidth> %for wide headings 
\def\tableskip{\noalign{\medskip}} %blank vert space 

\def\\{\centerline> %alt. def for centering 

\def\boxhead#l{\omit\hfill\vbox{\vskip2pt\normalbaselines\hsizelpty, 
#l\vskip2pt>\hfill>'/, #1 is lines of boxhead preceded by \\ and enclosed {> 

'/. 

'/. Leadertable macros 

\def\l#14#2\cr<\line{\strut#l\leaderfill#2» y,#l ... #2 

\def\ql#l&#2\cr{\line{\strut\hbox{\quad>#l\leaderf ill#2» '/.one left indent 

\def\qql#l&#2\cr{\line{\strut\hbox{\qquad>#l\leaderfill#2» '/.double indent 

'/. 

'/, Symboltables for NASA Technical Reports 
\def\s]rmboltable#l#2-C\tabskip :s 0pt\halign to \hsize{##\hfiliy. 

\tabskip 2em plus 2in minus 2em&\vtop{\hsize#l\noindent\raggedright% 
\strut##\strut>\hfill\cr#2» 

% 

’/, Indented version of Symboltable 

\def \ indent symtab#l#2{\tabskip=0pt\halign to \hsize{\hskipl . 5em##'/ t 

\hfiliy, 

\tabskip 2em plus 2in minus 2 em*\vtop{\hsize#l\no indent \raggedright’/C 
\strut##\strut>\hfill\cr#2» 

y. 

’/, Three column version of Symboltable 

\def\SYMB0LTABl.E#l#2{\tabskip=0pt\halign to \hsize{##\hfiliy. 

\tabskip 2em plus 2in minus 2em A'/, 
##\hfill&\vtop{\hsize#l\noindent\raggedrighty. 

\strut##\strut}’\hf ill\cr#2)-} 

y. 

’/, Basic table macro 

’/. Use: \table{<desired width>>{<table body including preamble>> 
\newdimen\digitwidth\newdimen\decimal width 
\def\table#l#2{\tabskip=3em plus Bin minus 3em'/, 
\setboxO=\hbox{\rmO>\digitwidth=\wdO'/, 

\setboxO=\hbox{\rm.>\decimalwidth=\wdOy, 

$$\vbox{\def ~<\kern\digitwidth>y, 

\def \ . {\kern\decimalwidth}'/, 

\baselineskiplOpt\off interlineskip'/, 

\halign to #l{\strut#2>>$$> 

•/. 

*/, Ruledtable is just like table, except that tabskip is set to 0, 

'/, initially. Tabskip glue with stretch and shrink must be specified 
’/, within the table’s preamble! Use this macro instead of \table 
'/, if you’re having problems with rules not meeting. 
\def\ruledtable#l#2{\tabskip=0pt$$\vbox{\setbox0=\hbox<\rm0>% 
\digitwidth=\wdO\def '{\kern\digitwidth}% 
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» 


\setboxO=\hbox{\rm. }\decimalwidth=\wdO\def \ . {\kern\decimalwidth}7, 
VbaselineskiplOptXoff interlineskip'/, 

\halign to #l{\strut#2>>$$> 

7. 

7, Boxtable is like table , but puts a box (rules) around entire table . 
\newdimen\tablewidth 

\def\boxtable#l#2{\tabskip=4em plus 6in minus 4em$$\boxittable{\vbox{7. 
\setboxO=\hbox<\rmO>\digitwidth=\wdO\def ~-{\kern\digitwidth>7. 
\setboxO=\hbox{\rm . >\decimalwidth=\wdO\def \ . {\kern\decimalwidth}7, 
\baselineskipl0pt\offinterline8kip7. 

\tablewidth=#l\advance\tablewidth by -0.8pt7, 

\halign to\tablewidth{\strut#2»>$$> 7.\table<width><table body> 

7. 

7. Hardboxtable combines the features of Ruledtable and Boxtable 
\def\hardboxtable#l#2{\tabskip=0pt$$\boxittable<7. 

\ s etboxO=\hbox{ \rmO>\digi t width* \ wd07. 

\setboxO=\hbox{\rm . }\decimalwidth=\wd07, 

\vbox{\def \ . {\kern\decioalwidth>7. 

\def<\kern\digitwidth>\baselineskipl0pt\offinterlineskip7. 
\tablewidth=#l\advance\tablewidth by -0.8pt7, 

\halign to\tablewidth<\strut#2>»$$> 7.\table<width><table body> 

7. 

7. Figure and Legend macros 

\def\figure#l#2{\topinsert\vskip#l\bigskip\centerline'(\ninept#2>\endinsert> 

\def\midfigure#l#2{\midinsert\vskip#l\bigskip\centerline{\ninept#2>\endinsert> 

\def\figurepar#l#2<\topinsert\vskip#l\bigskip\ninept\figleg{#2>\endinsert> 

\def \f i gl eg# 1 {\par \noindent \hang# 1 \par > 

7. 

7. 

7. MATH MACROS 
7. 

7. Misc . 

\def \ellipse-($\ldots$> 7. alternate def for . . . 

\def\bmatrix#l{\left[\matrix{#l>\right]> 7.\pmatrix with square brackets 
\def\Biggstrut{\vphantom{\Bigg(>> 

\def\biggstrut{\vphantom{\bigg(» 

\def\bigstrut{\vphantom{\big(» 

\def\Bigstrut<\vph 2 mtom i (\Big(» 

7. 

7, Superscripted hyphen 
\newbox\hyp 

\setbox\hyp=\hbox{\sevenrm-> 

\def \smallhyphen{\copy\hyp> 

7. 

7, Hyphen in math mode 

\newbox\hyphn 

\ s etbox\hyphn= \hbox{ \ r m - > 

\def \hyphen{\copy\hyphn> 

7. 
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'/. Slashed-form fractions 

\def \8lant#l#2{$\sevenrm\raise . 3em\hbox{#l}\kern- . 166em\raise2pt\hbox{/> 
\kern-l 2pt\hbox{\sevenrm#2>$> */, small (in-line) slashed-form fraction 
•/. 

*/• Partition matrix macros 

\catcode‘<B*ll %allow at signs to be letters, temporarily! 

\def \vdashrule{\vrule width 0.4pt height 6pt> 

\def\hdashrule{\hrule width 6pt height 0.4pt> 
\def\vdashes{\lower6pt\vbox{\baselineskip4\p® \lineskiplimit\zfl 
\kem6\p(D\hbox{\vdashrule>\hbox{\vdashrule>\hbox<\vdashrule»> 

\def \dashf ill{\xleaders\hbox to 7 . 5pt{\hss\leaders\hdashrule\hskip6pt\hss> 
\hf ill} 

\def\twodashes{\hbox to 15pt{\dashf ill}} ftforce two dashes 

\def \threedashes{\hbox to 22 . 5pt{\dashfill}} %force three dashes 

\catcode‘<5*12 '/, at signs are no longer letters 

V. 

’/. Change character definitions to allow bold lower case greek 
\mathchardef \alpha=”710B 
\mathchardef \bet a* ”7 IOC 
\mathchardef\gamma=”710D 
\mathchardef\delta*"71QE 
\mathchardef Xepsilon^^lOF 
\mathchardef \ z eta* ”7110 
\mat hchardef \ et a= ” 7 1 1 1 
\mathchardef \ theta* ”7112 
\mathchardef\iota =,, 7113 
\mathchardef \kappa* ”7114 
\mathchardef \lambda=”7115 
\mathchardef \mu= ”7116 
\mathchardef \nu= ”7117 
\mathchardef \xi=”7118 
\mathchardef \pi= ”7 1 19 
\mathchardef \rho*”711A 
\mathchardef \sigma=”711B 
\mathchardef \tau=”7llC 
\mathchardef \upsilon=”711D 
\mathchardef \phi=”7 1 IE 
\mathchardef \chi=”711F 
\mathchardef \psi*”7120 
\mathchar de f \ omega* ” 7 1 2 1 
\mathchardef \varepsilon=”7122 
\mathchardef \vartheta=”7123 
\mathchardef \ varpi* ”7124 
\mathchardef \varrho=”7125 
\mathcharde f \ var sigma* ”7126 
\mathchardef \varphi*”7127 
% 

% Redefine eqalignno to force the eqno to be in lOpt roman (MKM) 
\catcode‘<3=ll 
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\def\Eqalignno#l{\displfly\tabskip=\centering\halign to'/, 

\displaywidth{\hfil$\displaystyle{##}$\tabskip*0ptt7. 

$\displaystyle{{}##}$\hfil7. 

\tabskip=\centering&\llap{\tenrm ##>\tabskip=Opt\crcr#l\crcr>> 

7. 

’/, Align conditions to equations on right, and produce lO.Spt eqno (MKM) 
\def\Eqaligncondno#l{\displ®y\tabskip=\centering% 

\halign to\displaywidth{\hfil$\displaystyle{##}$\tabskip=0pt7, 
&$\displaystyle{{>##}$\hf il\tabskip=lem7, 
&\hfil$\displaystyle-C##}$\tabskip=\centering% 
&\llap{\tenrm##}\tabskip !s 0pt\crcr#l\crcr»7, 

\catcode‘ffl=12 

7. 

7, Allow type size of equations to change without affecting 
7. surrounding text (MKM) 

\def \eightptmath{\eightpt\baselineskip=12pt\fam=-l} 

\def \nineptmath-(\ninept\ba8elineskip s: 12pt\fam=-l> 

\def \tenptmath{\tenpt\fam=-l> 

7. 

7. Produce lOpt, roman equation number without extra braces (MKM) 

\def \Eqno (#1) {\eqno\hbox{\tenrm (#1) }}■ 

7. 

7. Trademark symbol (MKM) 

\def\trademark{$*{\hbox{\sevensy\char ’015\kern- .80em\fiverm R}>$> 

7. 

7. 

7, FORMAT MACROS 

7 . 

7 . Double column format 

\newif\ifdbl\dblfalse 7. doublecolumn format? (initially false) 

\def \doublecoH\ifdbl\relax\else\input dblcol\global\dbltrue\fi> 

7 . 

7. Splitcol output format (See file for documentation) 
\def\splitcol{\input splitcol\relax> 

7. 

7. Footnote with superscripted ref mark, and smaller font text 
\def \fn#l#2{{\baselineskipl0pt\eightpt\footnote{#lM#2}» 

7. 

7. Level two heading font 

\font\romanboldbigten=ambxiO scaled \magstephalf 
\def\levtwof ont{\baselineskip 12pt\romanboldbigten> 

7 . 

7. Level one heading. (Hyphenation and page breaks prevented — MKM) 
\def\levelone#l{\vbox{\rightskip=Opt plus lfil \spaceskip= 3333em 
\xspaceskip= . 5em \pretolerance=9999 \tolerance=9999 
\hyphenpenalty=9999 \exhyphenpenalty=9999 
\twelvept\noindent\bf #l}\par\nobreaLk\medskip} 

\def \leveltwo#l{\vbox{\leftskip=\parindent\rightskip=Opt pluslfil7t 
\spaceskip= . 3333em\xspaceskip= . 5em\pretoleremce=9999\tolerance=99997. 
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\hyphenpenalty=9999\exhyphenpenalty=9999\levtwofont\noindent#l}\pary, 

\nobreak\medskip> 

X 

’/, Level three heading 

\def \levelthree#l{\relax\par\vskip2pt\indent{\IT#lM\bf . » 

X 

'/, Medium skip with no stretch (and very little shrink) 
\def\solidmedskip{\vskip 6pt plus Opt minus lpt> 

X 

'/, Head and foot lines 

\def \runhead#l-{\headline= ! {\hfill\tenrm#l\hfill}} 
\def\lftfootline{\tenbf\folio\hss> 

\def \rtf ootline{\tenbf \hss\folio> 

\footline={\ifodd\pageno\rtfootline\else\lftfootline\fi} 

\headline=<\hfill> 

X 

’/, Title font 

\font\romanboldfourteen=ambxlO scaled \magstep2 
\def\tlf ont{\baselineskip 16pt\romanboldfourteen> 

X 

'/, "Cosati" or "Abstract" page 

\def \begincosati{\input cosati\relax> 

X 

’/, Table of Contents generation 

\newwrite\ct 

\def \contents{'/, 

\message{Please type the filename for contents:} 

\readl6 to\filename 

\immediate\openout\ct=\filename 

\immediate\write\ct{\string\input> 

\immediate\write\ct{larcmacs} 

\immediate\write\ct{\string\footline={\string\hss\string\tenbfy, 

\string\folio\string\hss}} 

\immediate\write\ct{\string\pageno=-3 \string\hsize=35pc\string\parindent=0pt> 
\immediate\write\ct{\string\levelone{Contents}> 

%new definitions for heading macros 

\def\levelone##l{\vbox{\rightskip=Opt plus lfil \spaceskip= . 333em 
\xspaceskip= . 5em \pretolerance=9999 \tolerance=9999 
\hyphenpenalty=9999 \exhyphenpenalty=9999 
\twelvept\noindent 

\write\ct{\string\medskip\string\line<##l\string\leaderf ill{\folio}}> 
\bf##l}\par\nobreak\medskip> 

\def\leveltwo##l{\vbox{\leftskip=\parindent\rightskip*Opt plus lfil 
\spaceskip=.3333em \xspaceskip=.5em \pretolerance=9999 \tolerance=9999 
\hyphenpenalty=9999 \exhyphenpenalty=9999 \levtwofont\noindent 
\write\ct{\string\smallskip\string\line{\string\quad<##l}\string 
\leaderfill{\folio}» 

##l}\par\nobreak\medskip> 

\def \levelthree##l{\relax\par\vskip2pt\indent 
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\write\ct{\string\line{\string\qquad{##l}\string\leaderfill{\folio}}} 
{\IT ##l>{\bf .» 

}*/, end contents macros 

% 

% Hyphenation exceptions 

•/, Create your own hyphenations.tex file with exceptions to TeX’s 
•/, hyphenation rules. You will need to remove the % proceeding the 
•/ 0 following line: 

•/o\input hyphenations.tex 

% 

% 

7. FONT MACROS 

% 

% Different size fonts 

Xnewif \ifbfl\bf lfalse % big fonts loaded? (initially false) 

% 

% Seven point roman font family 

\def\sevenpt{\normalbaselineskip=9pt\normalbaselines% 
\textfontO=\sevenrm\scriptfontO=\f ivermXscriptscriptfontO^Xf iverm*/* 
Xdef \rm{\famO\sevenrm}\rmy # 

Xtextfontl^XseveniXscriptfontl^XfiveiXscriptscriptfonti^Xf ivei'/, 
Xdef\mit{\faml}Xdef \oldstyle{\faml\seveni}y t 

\textfont2 s =\sevensy\scriptfont2 :sf \sevensy\scriptscriptfont2=\fivesyy # 
\def \cal{\fam2>y, 

\textfont3=\tenex\scriptfont3= : \tenex\scriptscriptfont3 aE \tenexy t 
Xdef \it{\fam\itfam\sevenit> # / t \it is family 4 
\textfont\itfam-\sevenity, 

Xdef \bf {XfamXbffamXsevenbf} 8 /, \bf is family 6 
\textfont\bff 2 im=\sevenbf \scriptfont\bffam=\sevenbf f / i 
\scriptscriptfont\bff am=\fivebf> 

y. 

*/, Eight point roman font family 

Xdef \eightpt{\normalbaselineskip= s 10pt\normalba8elinesy # 

\f ontXeighttt^amttQy, 

XtextfontO= i \eightrm\scriptfontO=\sevenrm\scriptscriptfontO“\sixrm # / # 
Xdef \rm{\f amO\eightrm>\rmy, 

\textfontl=\eighti\scriptfontl=\seveni\scriptscriptfontl=\sixiy, 

Xdef \mit{\f ami) Xdef \oldstyle{\faml\eighti>y, 

\textfont2=\eightsy\scriptfont2=\sevensy\scriptscriptfont2 ss \sixsyy* 
Xdef \cal{\f am2}°/ 0 

\textfont3=\tenex\scriptfont3=\tenex\scriptscriptfont3=\tenexy, 
\def\it{\fam\itfam\eightit>y i \it is family 4 
\textfont\itfam=\eightity, 

Xdef \bf {XfamXbffamXeightbf}*/, \bf is family 6 

\textfont\bffam=\eightbf\scriptfont\bffam=\sevenbfy, 

\script8criptfont\bffam=\sixbfy o 

Xdef \tt{\fam\ttfam\eighttt>y, \tt is family 7 

\textfont\ttfam=\eighttt> 

% 
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*/* Bigeight and Bigten point font families used at TEB: here * 8 and 10 pt 
\def \bigeightpt{\eightpt\relax> 

\def \bigtenpt{\tenpt\relax> 

% 

*/, Nine point roman font family 

\def \ninept{\normalbaselineskip=llpt\normalbaselines% 

\textf ontO=\ninerm\scriptfontO=\sevenrm\scriptscriptfontO=\sixrm% 

\def \rm{\famO\ninerm>\rm% 

\textfontl=\ninei\scriptf ontl=\seveni\scriptscriptfontl ss \sixiy, 
\def\mit<\faml>\def\oldstyle{\faml\ninei>y. 

\textfont2=\ninesy\scriptfont2=\seven8y\script8criptfont2=\sixsyy, 

\def \cal{\f am2>% 

\textf ont3=\tenex\scriptf ont3=\tenex\scriptscriptfont3 ! =\tenexy # 

\def\it{\f am\itfam\nineit} # /, \it is family 4 
\textfont\itfam=\nineit'/, 

\def \bf{\fam\bffam\ninebf>% \bf is family 6 
\textfont\bffam=\ninebf \scriptfont\bffam=\sevenbf% 
\scriptscriptfont\bffam=\sixbf > 

% 

% Ten point roman font family (default) 

\def\tenpt{\normalbaselineskip=12pt\normalbaselinesy t 

\textf ontO=\tenrm\scriptf ontO=\eightrm\scriptscriptf ontO=\sixrm% 

\def \rm{\famO\tenrm}\rmy # 

\textfontl=\teni\scriptfontl=\eighti\scriptscriptfontl*\sixi # /. 

\def \mit{\faml>\def \oldstyle{\faml\teni>% 

\textfont2=\tensy\scriptfont2=\eightsy\scriptscriptfont2=\sixsyy i 
\def \cal{\f am2>y, 

\textfont3=\tenex\scriptfont3=\tenex\scriptscriptfont3-\tenexy, 

\def \it{\fam\itfam\tenit>y, \it is family 4 
\textf ont\itf am=\tenity, 

\def \sl{\f am\slfam\tensl}y* \sl is family 5 

\textfont\slf am=\tensiy o 

\def\bf {\fam\bffam\tenbf>y, \bf is family 6 

\textfont\bf f am=\tenbf \scriptfont\bffam=\eightbfy # 

\scriptscriptfont\bffam=\sixbf 

\textfont\ttf am=\tentt 

\def \tt{\f am\ttfam\tentt> % \tt is family 7 

\textfont9=\tenbi\scriptfont9=\eighti\script8criptfont9=\sixiy # 

\def \bmit{\f am9» 

•/. 

% Eleven point font family 
\def \elevenpt{y # 

\ifbf l\relax\else\input bigf onts\global\bf ltrue\f i 
\textfontO=\elevenrm \scriptfontO=\tenrm \8criptscriptfont0=\eightrm 
\def \rm{\famO\elevenrm}\rm 

\textfontl=\eleveni \scriptf ontl=\teni \scriptscriptfontl=\eighti 
\def \mit{\faml> \def \oldstyle{\f aml\eleveni> 

\textfont2=\elevensy \scriptfont2=\tensy \scriptscriptfont2=\eightsy 
\def \cal{\fam2> 


l 
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\textfont3=\elevenex \scriptfont3=\elevenex \scriptscriptf ont3=\elevenex 
\def \it{\fam\itfam\elevenit> % \it is family 4 
\textfont\itfam-\elevenit 

\def\bf{\fam\bffam\elevenbf> % \bf is family 6 
\textfont\bffam=\elevenbf XscriptfontNbffam^Xtenbf 
\scriptscriptfont\bffam=\eightbf 
\normalbaselineskipl3pt\normalbaselines} 

% 

*/, Twelve point font family 
\def\twelvept{ , / i 

\ifbf l\relax\else\input bigf onts\global\bfltrue\f i 

\t extf ontO=\twel v erm \scriptf ontO=\tenrm \scriptscriptfontO=\eightrm 

\def \rm{\famO\twelverm}\rm # / # 

\textfontl=\twelvei \scriptf ontl~\teni \scriptscriptfontl=\eighti 
\def\mit{\faml> \def \oldstyle{\fami\twelvei> 

\textfont2=\twelvesy \scriptfont2 ss \tensy \scriptscriptfont2=\eightsy 
\def \cal{\f am2> 

\textf ont3=\twelveex \scriptfont3=\twelveex \scriptscriptfont3=\twelveex 
\def\it{\fam\itfam\twelveit> % \it is family 4 
\textf ont\itfam=\twelveit 

\def \bf{\fam\bffam\twelvebf} 7, \bf is family 6 
\textfont\bffam-\twelvebf \scriptfont\bffam-\tenbf 
\scriptscriptfont\bffam=\eightbf 
\normalbaselineskipl4pt\normalbaselines} 

7 . 

7. Larger roman fonts for report headings 
7Adef \slidefont{\input slidefnt\relax} 

y. 

7. Sanserif fonts 

\def\tensans{\font\ss=amsslO\f ont\88i=amssil0\font\ssb=amssbxl07* 

\input sansXnull} 

\def\eightsans{\font\ss=amssq8\f ont\ssi=amssqi8\font\ssb-amssbx87. 

\input sans\null> 

% 

% Define preloaded and magnified fonts 
\font\boldit=ambilO 7 e math bold italic 

\font\IT=amsllO 7*text bold italic at TEB (Here, slanted) 

7. 

\font\ninerm=amr9 7* smaller roman text fonts 

\font\eightrm=amr8 

\f ont\sixrm=amr6 

7. 

\font\ninei=ammi9 7, math italic 

\f ont\eighti=ammi8 
\font\sixi=ammi6 

7. 

\font\tenbi=ambilO 7* bold math italic 

\font\eightbi=ammi8 % (here, 8pt is just math italic, not bold) 
\font\sixbi=ammi6 7. " 6 " " 
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7 . 

\font\ninesy=amsy9 % math symbols 

\font\eightsy=amsy8 
\font\sixsy=amsy6 
% 

\font\ninebf=ambx9 7 . boldface extended 

\ f ont \ e i ght bf =ambx8 
\f ont \sixbf =ambx6 
% 

\font\nineit=amti9 7, text italic 

\font\eightit=amti8 

\font\sevenit=amti7 

7 . 

7,\font\capsfont=amcscl0 7* caps and small caps font 

7 . 

7 , TEB parameters 

\def \enddbl{\vf ill\ej ect\end> 

\baselineskip 12pt 

\abovedisplayskip=12pt plus 2pt minus 2pt 

\belowdisplayskip=12pt plus 2pt minus 2pt 

\toler£Lnce 1500 

\pretolerance 500 

\hoffset -0.25in 

\voffset Oin 

\parindent 1 . 5em 

\hsize 42pc 

\vsize 55pc 

\tenpt 

\endinput 
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7. This is BIGFONTS.TEX as of April, 1987. 

% 

% Eleven and Twelve point fonts 

7 . 

NglobalXfontXtwelverm^amrlO scaled \magstepl 
\global\f ont\twelvebf-ambxlO scaled \magstepl 
\global\f ont\twelvei=ammilO scaled \magstepl 
\global\f ont\twelvesy~amsylO scaled \magstepl 
\global\f ont\twelveex-amexlO scaled \magstepl 
XglobalNfontXtwelveit^amtilO scaled \magstepl 
\global\f ontXelevenrm^amrlO scaled \magstephalf 
\global\f ont\eleveni=ammilO scaled \magstephalf 
XglobalXfontXelevensy^amsylO scaled \magstephalf 
\global\font\elevenex=amexlO scaled \magstephalf 
\global\font\elevenbf =ambxlO scaled \magstephalf 
\global\font\elevenit=amtilO scaled \magstephalf 
\global\bf ltrue 
\endinput 
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*/. This is COSATI.TEX as of April. 1987. 

% 

% BEGINCOSATI 

\hoff set-1 . Oin\voff setO . Oin 

\newbox\agency 

\setbox\agency=\hbox{\eightrm Sponsoring Agency Code} 
\def\army{\setbox\agency=\hbox{\eightrm Army Project No.}} 

\hsize8 . 5in\nopagenumbers\vsizellin\parindent0pt 

\newdimen\extra\extra=46pc ‘/.height of table minus 1st and last rows 

\newdimen\dmin\dmin=3pc 

\newdimen\gmin\gmin=2pc 

\newdimen\imin\imin=3 . 5pc 

\newdimen\lmin\lmin=3pc 

\newdimen\qmin\qmin=lin 

\newdimen\qsize\qsize=lin 

\def \\{\hf il\break} 

\newbox\boxa\newbox\boxb\newbox\boxc\newbox\boxd\newbox\boxe\newbox\boxf 

\newbox\boxg\newbox\boxh\newbox\boxi\newbox\boxj \newbox\boxk\newbox\boxl 

\newbox\boxm\newbox\boxn\newbox\boxo\newbox\boxp\newbox\boxq\newbox\boxr 

\newbox\boxs\newbox\boxt\newbox\boxu\newbox\boxv\newbox\boxw\newbox\boxx 

\newbox\boxy\newbox\boxz\newbox\trash 

\def \one#l{\setbox\boxa=\hbox{\strut\quad#l\quad}} 

\def\two#l{\setbox\boxb=\hbox{\strut\quad#l}} 

\def\three#l<\setbox\boxc= : \hbox{\strut\quad#l}} 

\def \four#l{\setbox\boxd=\vbox{\hsize=25pc\strut#l\strut\hfil}} 
\def\five#l{\setbox\boxe=\hbox{\strut\quad#l}} 

\def \six#l{\setbox\boxf=\hbox{\strut\quad#l}} 
\def\seven#l{\setbox\boxg=\vbox{\hsize ss 25pc\strut#l\strut\hfil}} 

\def \eight#l{\setbox\boxh=\hbox{\strut\quad#l}} 

\def \nine#l{\setbox\boxi=\vbox{\hsize= s 25pc\strut#l\strut\hf il}} 

\def \ten#l{\setbox\boxj=\hbox{\strut\quad#l}} 

\def \eleven#l{\setbox\boxk=\hbox{\strut\quad#l}} 

\def \twelve#l{\setbox\boxl=\vbox{\hsize=25pc\strut#l\strut\hfil}} 

\def \thirteen#l{\setbox\boxm=\hbox{\strut\quad#l}} 

\def \fourteen#l{\setbox\boxn=\hbox{\strut\quad#l}} 

\def \f ifteen#l{\setbox\boxo=\vbox{\hsize38pc\strut#l\stmt\hfil}} 

\def\ sixteen# l{\setbox\boxp=\vbox{\hsize38pc\strut#l\strut\hfil}} 
\def\seventeen#l{\setbox\boxq=\vbox{\hsize20pc#l\hfil}} 

\def \eighteen#l{\qsize=\ht\boxq\ifdim\qsize<lin\qsize=lin\fi 
\setbox\boxr=\vbox to\qsize{\hsize20pc\strut#l\hf il\vf il}} 

\def \nineteen#l{\setbox\boxs=\hbox{\strut\quad#l}} 

\def \twenty#l{\setbox\boxt=\hbox{\strut\quad#l}} 

\def \twentyone#l{\setbox\boxu=\hbox{\strut\quad#l}} 

\def \twentytwo#l{\setbox\boxv=\hbox{\strut\quad#l}} 
\setbox\boxa=\null\setbox\boxb=\null\setbox\boxc=\null 
\setbox\boxd=\vbox to 3pc{\hsize= s 26pc\hfil\vf il}\setbox\boxe=\null 
\setbox\boxf =\null 

\setbox\boxg=\vbox to 2pc{\hsize=26pc\hf il\vf il}\setbox\boxh=\null 
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\setbox\boxi=\vbox to 3.5pc{\h8ize*26pc\hfil\vfil>\setbox\boxj=\null 
\setbox\boxk=\null 

\setbox\boxl=\vbox to 3pc{\hsize=26pc\hfil\vfil}\setbox\boxm=\null 
\ s e tbox\boxn= \nul 1 

\setbox\boxo=\vbox to 4 . 5pc{\hsize37pc\hfil\vfil> 

\setbox\boxp=\vbox to 23pc{\hsize37pc\hfil\vf il} 

\setbox\boxq=\vbox to lin{\hsize=20pc\hfil\vfil} 

\setbox\boxr=\vbox to lin{\hsize=20pc\hfil\vfil} 

\setbox\boxs=\null\setbox\boxt=\null\setbox\boxu=\null 

\ s etbox\boxv=\nul 1 

\newbox\leftbox\newbox\rightbox 

% ENDCOSATI 

\def\endcosati{\eightpt 

\advance\dmin by -\ht\boxd\advance\gmin by -\ht\boxg 
\advance\dmin by -\dp\boxd\advance\gmin by -\dp\boxg 
\advance\imin by -\ht\boxi\advance\lmin by -\ht\boxl 
\advance\imin by -\dp\boxi\advance\lmin by -\dp\boxl 
\setbox\lef tbox=\vbox{\hsize323 . 6pt% 

'/, Width of leftbox is 27pc - width of rule in middle (0.4pt) 
\vbox{\leftline{\strut\ 4. Title and Subtitle} 

\hbox to \hsize{\quad\copy\boxd\hfill} 

\ifdim\dmin>Opt \vbox to \dminO\fi} 

\hrule 

\vbox<\leftline{\strut\ 7. Author(s)} 

\hbox to \hsize-C\quad\copy\boxg\hfill} 

\ifdim\gmin>Opt \vbox to \gminO\fi} 

\hrule 

\vbox{\leftline{\strut\ 9. Performing Organization Name and 
Address} 

\hbox to \hsize{\quad\copy\boxi\hf ill} 

\ifdim\imin>Opt \vbox to \iminO\fi} 

\hrule 

\vbox{\leftline{\strut\ 12. Sponsoring Agency Name and Address} 

\hbox to \hsize{\quad\copy\boxl\hf ill} 

\if dim\lmin>Opt \vbox to \lminO\fi} 

} 

\setbox\rightbox=\vbox to\ht\lef tbox-(\hsize=13pc 
\leftline{\strut\ 5. Report Date}\vfill 
\hbox to \hsize{\strut\copy\boxe\hfill}\vfill 
\hrule 

\leftline{\strut\ 6. Performing Organization Code}\vfill 

\hbox to \hsize-C\strut\copy\boxf\hfill}\vfill 

\hrule 

\leftline{\strut\ 8. Performing Organization Report No.}\vfill 

\hbox to \h8ize{\strut\copy\boxh\hfill}\vfill 

\hrule 

\leftline{\strut\ 10. Work Unit No.}\vfill 
\hbox to \hsize{\strut\copy\boxj \hf ill}\vf ill 
\hrule 
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\leftline{\strut\ 11. Contract or Grant No.}\vfill 
\hbox to \hsize{\strut\copy\boxk\hf ill}\vf ill 
\hrule 

\leftline{\strut\ 13. Type of Report and Period Covered}\vf ill 

\hbox to \hsize{\strut\copy\boxm\hf ill}\vfill 

\hrule 

\leftline{\strut\ 14. \box\agency>\vfill 
\hbox to \hsize{\strut\copy\boxn\hf ill}\vfill 
> 

\advance\extra by -\ht\leftbox\advance\extra by -\dp\leftbox 
\advance\ extra by -\ht\boxo\advance\extra by -\dp\boxo 
\advance\extra by -\ht\boxp\advance\extra by -\dp\boxp 
\ifdim\qsize<lin\advance\extra by -lin\else\advance\extra by -\qsize\fi 
\advance\qmin by -\ht\boxq\advance\qmin by -\dp\boxq 
\hardboxtable{40pcM##&\hbox to 13 . 455pc{##\hf il}ft% 

\ vr ul e##&## \hf i 1 \hbox to 3pc{>\tabskip0pt plus40pt minus lOpt&Xvrule##*/, 

\tabskipOptfc##\hfil&\vrule##fe##\hfil\cr 

\tablerule 

\noalign{\vbox to 32pt{\vf ill\hbox to 40pc{\hf ill\twelvept Report 
Documentation Page\hf ill}*/, 

\vf ill}} 

\tablerule 

\strut&\ 1. Report No.&&\ 2. Government Accession No.&& 

\multispan3{\ 3. Recipient's Catalog No.\hfil}\cr 
<fe\copy\boxa\hfil&&\copy\boxb\hf il&&\multispan3{\copy\boxc\hf il}\cr 
\tablerule 

*/,\multispan4{\copy\leftbox}&&\multispan3{\copy\rightbox}\cr 

\noalign{\hbox{\copy\leftbox\vrule\copy\rightbox}} 

\tablerule 

\multispan8{\strut\ 15. Supplementary Notes\hfil}\cr 

\multispan8{\hf il\copy\boxo\hf il}\cr 

\tablerule 

\multispan8{\strut\ 16. Abstract\hf il}\cr 

\raultispan8{\hfil\copy\boxp\hfil}\cr 

\noalign{\vskip\extra} 

\tablerule 

\multispan8{\hbox to 3 . 5in{\strut\ 17. Key Words (Suggested by Authors (s)) 
\hfil}\vrule\ 18. Distribution Statement \hfil}\cr 
\multispan8{\hbox to 3 . 5in{\quad\if dim\qmin>Opt\vbox to lin{\copy\boxq\vf il} 
\else\copy\boxq\f i\hf il}\vrule\quad\copy\boxr\hf il}\cr 
\tablerule 

&\strut\ 19. Security Classif . (of this report) \quad£A\ 20. Security 
Classif.(of this page)\quad&&\ 21. No. of Pages\ tk\ 22. Price\cr 
&\strut\copy\boxs\hf il&&\copy\boxt\hfilfefc\copy\boxu\hfilfc&\copy\boxv\hfil\cr 
\tablerule} 

\vskip-0.7pc 

\leftline{\hskip 0 .92in{\eightbf NASA FORM 1626} \sixrm OCT 86 \hfill 
NASA-Langley , 1987\hskip0 . 92in} 

\centerline{For sale by the National Technical Information Service, 
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Springfield, Virginia 22161-2171} 
\vfill\eject} 

\endinput 
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% 

% This is DBLCOL.TEX as of April, 1987. 

% 

*/, To produce double column output, simply put "\doublecol" 

*/, at the top of your file after M \input larcmacs". 

% (Or you may use this file directly without larcmacs by 
# / t putting M \ input dblcol 11 instead.) 

% 

’/. Double column output using this macro has the advantage that 
*/, inserts and footnotes still work (on a column by column basis) . 

% The disadvantage is that it does not provide an easy way to 
# / t switch back and forth between double and single column format. 

y. 

•/. The dimensions of a page output with this format are as follows: 

•/, \fullhsize - width of both columns plus space between (42pc) 

•/, \hsize - width of a single column (20pc) 

% \vsize - height of a column (55pc) 

% 

% All of the insert macros (\topinsert, \midinsert, \pageinsert, and 
'/. \footnote) work on columns instead of full pages. For example, 

'/, \pageinsert will leave a blank column. A new macro, \fullpageinsert 
'/. is defined to leave an entire blank page. 

y. 

\newdimen\fullhsize 
\fullhsize=42pc \hsize=20pc 
\vsize 55pc 

\def\toplevel#l{\vfill\supereject\fullline{\hfill{\tlfont#l>\hfill>y t 
\vbox to 9pt{\hsize=\fullhsize\vf ill}} 

\def\fullline{\hbox to \fullhsize> 

\newcount\fullpagecount 

\def \fullpageinsert{\advance\fullpagecount byl\message{fpi+ +++++♦+++++++■►}} 
\let\lr=L \newbox\leftcolumn 
\output={\if L\lry, 

\global\setbox\leftcolumn=\columnbox \global\let\lr=Ry, 

\else \doubleformat \global\let\lr=L\fiy, 

\if num\outputpenalty>-20000 \else\dosupere j ect\f i> 

\def \doubleformat{\shipout\vbox{\makeheadliney, 
\fullline{\box\leftcolumn\hfil\columnbox>y # 

\makef ootline}'/, 

\advanc epageno'/, 

\ifnum\fullpagecount>0\shipout\vbox{\makeheadline\vfill\makefootline> 
\message{ (BLANK PAGE \the\pageno ! ) }*/, 

\global\advance\fullpagecount by-l\message{ fpi> 

\advanc epageno\f i}*/, 

\def\columnbox{\leftline{\pagebody» 

y. 

\def \f inishinserts{\if num\f ullpagecount>oy, 

\loop\hboxO\vf ill\eject\global\adv 2 Uice\fullpagecount by-1% 
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\message{ (BLANK PAGE \the\pageno ! ) >7. 
\ifnum\fullpagecount>0\repeat} 

7. 

\def\makeheadline{\vbox to 0pt{\vskip-22.5pt7. 

\f ullline{\vbox to8 . 5pt{}\the\headline}\vss}\nointerlineskip} 
\def\makefootline{\baselineskip24pt\fullline{\the\footline}} 

7. 

\def\doubleeject{\supereject\if R\r \null\vfill\eject\f i} 
\def\enddbl{\supereject\if R\lr \null\vfill\eject\fi\end} 

7. 

\message{ [Typesetting double column format....]} 

\endinput 
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7, This is SPLITCOL.TEX as of April, 1987. 

7 . 

7. The \splitcol macro (output routine) was developed by Mary McCaskill 
7. to allow balancing of columns and switching from double columns to 
7. single column output. 

7. 

7. The \splitcol macro is used as follows: Include "\input splitcol" 

7. at the beginning of your file. (Or, if you already have "\input larcmacs" , 
7. then you only need to put "\splitcol") . Your text will come out in 
7. single column format by default. To switch to double column format, 

7. use \begindoublecol and \enddoublecol . 

7. 

7. The format commands used within splitcol are as follows: 

7. 

7. \begindoublecol \splitcol produces single column pages until 
7. this command appears, then begins double column 

7. 

7. \enddoublecol This command causes the columns to be balanced 
7> and changes the format back to single column. 

7. \enddoublecol precedes \vfill\eject when a file 
7. ends with double columns. 

7. 

7. \columnbreak Strongly encourages a break for the left column. 

7. (See note (1) below) . This command must be used 
7. in vertical mode or in a \vadjustO. 

7. 

7 , \shortcol Allows the right column to be short when balancing 
7, columns. Precedes \enddoublecol . 

7. 

7 , The \splitcol command has some drawbacks: 

7 . 

7 , (1) It is tricky to force left column breaks. You may use the \columnbreak 

7, command above to encourage a break. If you try to force a break with 

7 . \eject, instead you will get a blank right column! 

7. 

7 , (2) There can be no \topinserts, \midinserts, or footnotes in a file 

7 . using \splitcol. \pageinsert may work. You can sometimes get around 
7. this by splitting up your document into one or more files. 

7. 

7. (3) \splitcol does not affect the current font, but it does change the 

7 , \baselineskip to 13pt in single column format. You may re-specify 
7. \baselineskip after \splitcol if you desire. 

7. 

7. Questions/Problems concerning the use of splitcol should be directed to 
7, Mary McCaskill x3325. 

7, 

\hsize=42pc \vsize*55pc \baselineskip"13pt \maxdepth»2 . 2pt 
\newdimen\pageheight \pageheight«*\vsize 
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\newdimen\pagewidth \pagewidth=\hsize 
\newdimen\colwidth \newdimen\bigcolheight 

\colwidth=20pc \bigcolheight=112pc */ t bigcolheight is a little more than 2\vsize 

V. 

\output{\onepageout{\unvbox255}} 

•/. 

\newbox\partialpage \newdimen\savesize 

\def \begindoublecol{\begingroup\savesize=\vsize 

\output={\global\setbox\partialpage*\vbox{\unvbox255\bigskip» 

\eject */ # put single col on current page into \partialpage 
\output={\doublecolumnout} 

\hsize=\colwidth \vsize=\bigcolheight \baselineskip=12pt 
\advance\vsize by -2\ht\partialpage V.subtract partialpage height from 
\me8sage{ [Typesetting double columns ...]}} % \vsize 

% 

\def\enddoublecol{\message{ [Balancing columns ...]} 

\output{\balancecolumns} \eject 
\global\output-{\onepageout{\unvbox255» 
\global\vsize-\savesize\endgroup\pagegoal s \vsize 
\baselineskip=13pt \message{ [Typesetting single column ...]}} 

% 

\def\doublecolumnout{\dimenO=\pageheight 

\advance\dimenO by -\ht\partialpage # / t subtract partialpage height from 

*/. vsize 

\splittopskip=\topskip \splitmaxdepth=\maxdepth 

\setbox0=\vsplit255 to \dimenO \setbox2=\vsplit255 to \dimenO # / # split 

’/•bigcolumn 

\onepageout\pagesof ar 
\global\vsize=\bigcolheight 

\unvbox255\penalty\outputpenalty> '/.put rest of box255 back in vert list 

% 

\def\pagesof ar{\unvbox\partialpage ‘/.output partialpage (single col) 

\wdO=\hsize \wd2=\hsize 

\hbox to \pagewidth{\boxO\hf il\box2>> '/.put cols together 

% 

\def \balancecolumns{\setbox0=\vbox{\unvbox255> XdimenO^XhtO 

\advance\dimenO by \topskip \advance\dimenO by -\baselineskip 
\divide\dimenO by 2 

\splittopskip=\topskip \splitmaxdepth=\maxdepth 
{\vbadness=10000 \loop \global\setbox3=\copy0 

\global\setboxl=\vsplit3 to \dimenO \ifdim\ht3>\dimen0 
\global\advance\dimenO by lpt \repeat> ‘/.loop to balance cols 
\setboxO=\vbox to \dimenO{\unvboxl> 

\ifnum\shrt=0 \setbox2=\vbox to \dimen0{\unvbox3> 

\else \8etbox2=\vbox to \dimen0{\dimen2 s =\dp3 \unvbox3 \kern-\dimen2\vf il> 
\fi Xshrt^O 

\global\output={\balancingerror> 

\pagesofar} 

% 
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\newhelp\balerrhelp{Please change the page into one that works. > 

7 . 

\def\balancingerror{\errhelp=\balerrhelp \errmessage{Page can’t be balanced.) 
\onepageout{\unvbox255» 

7 . 

\def\onepageout#l{\shipout\vbox{\makeheadline \vbox to \pageheight{#l) 
\makefootline> \advancepageno \ifnum\outputpenalty>-20000 
\else\dosupere j ect\f i> 

7 . 

\def\makefootline<\baselineskip24pt \hbox to \pagewidth{\the\footline» 

% 

\def\makeheadline'{\vbox to 0pt{\vskip-22.5pt 

\hbox to \pagewidth{\vbox to 8 . 5pt<>\the\headline>\vss> \nointerlineskip> 

7 . 

\def\colnmnbreak{\penalty-5000> 7, for breadcing at bottom of left column 

7 . 

\newcount\shrt \shrt=0 

\def\shortcol{\shrt=l> 7.to allow right column to be short when balanced 
\endinput 


The following file is not a part of LARCMACS, but is available on request. It may be used 
with or without LARCMACS. 


'/.This is file draft.tex to setup format for rough drafts for 
% Technical Editing 
'/.IMPORTANT! MM 

'/.If used with larcmacs, remove the '/, from the line below 
\input larcmacs \twelvept 

'/.If used without larcmacs, remove the '/. from the line below 
% \magnif ication=\magstepl 
'/.Page size for 8 1/2 by 11 paper 
\hsize=6.5 true in 
\vsize=9 true in 
'/.Text will be double spaced 
'/.Definition to be used in heading macros 
'/.Causes lines to be centered across page 
\newdimen\skipdimen \newdimen\plusdimen 
\def\raggedc enter {\skipdimen=\hsize\divide\skipdimen by2 

\plusdimen=\skipdimen\divide\plusdimen by3 
\multiply\plusdimen by 2 
\advance\skipdimen by -\plusdimen 
\leftskip-\skipdimen plus\plusdimen \rightskip=\leftskip 
\parfillskip=Opt \spaceskip=.3333em \xspaceskip=.5em 
\pretolerance=9999 \tolerance=9999 \hyphenpenalty=9999 
\exhyphenpenalty ss 9999> 

'/.Definitions of three heading levels 
'/.First heading level is centered in boldface type 
\def \levelone#l{\goodbreak\vskipl8pt 

\vbox{\raggedcenter\noindent\bf #1} 

\par\bigskip\nobreak} 

'/.Second heading level is on left margin in boldface type 
\def \leveltwo#l{\goodbreak\vskipl8pt 

\vbox{\rightskip=Opt plus lfil \spaceskip= . 3333em 
\xspaceskip= . 5em \pretolerance=9999 \tolerance=9999 
\hyphenpenalty=9999 \exhyphenpenalty=9999 
\noindent\bf #1} 

\par\nobreak\medskip} 

'/.Third heading level is run-in at beginning of paragraph in italic type 
'/.NOTE: the period is included in the macro 
\def \levelthree#l{\goodbreak\medskip 
{\it #1.}\ > 

'/.These heading macros are followed by the heading in O; for example, 

'/, \levelone{Introduction> 

*/, \leveltwo{Experimental Facility} 

'/, \levelthree{Data for first configuration} 

'/. NOTE: no period after heading 
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Appendix B 
Sample Report 

This* appendix presents the TJkiX document file and the typeset results for a “typical” NASA 
report. Please realize that this is a make-believe report that has been composed to illustrate 
the use of LARCMACS; it is not intended to represent a necessarily well-written report. (In 
fact, a real report was torn apart and pieced together at random.) 

T feX Document File 

The first file is for the body of the report: 


'/,'/, This file is the body of a report 
\input larcmacs 

\contents '/.'/.Create a file for Contents page 
\doublecol '/, '/.Double- column format 
\levelone{Summary} 

Wind shear is considered by many in the aviation community to be one of the 
major safety issues facing their industry. The Federal Aviation 
Administration has addressed this problem through an integrated wind shear 
program plan, which incorporates the expertise of industry, universities, and 
various government agencies such as the National Aeronautics and Space 
Administration, the National Oceanic and Atmospheric Administration, and the 
Department of Defense. The plan is aimed at reducing the hazard of 
low-attitude wind shear through improved training and operating procedures, 
wind shear detection systems, and flight guidance systems. 

\bigskip 

\levelone{Introduction> 

Wind shear is considered by many in the aviation industry to be one of their 
major safety issues. Listed in table~l are 32*TJ.S.\ aircraft accidents or 
incidents that have occurred from 1964 to 1985 and were attributed 
to low-altitude wind shear (refs.~l and 2). The crash of Delta 
flight~191 on August“2, ~1985, in which 135~people died while on an 
approach to landing at Dallas-Fort Worth International Airport, is the latest 
reminder of the danger of this weather phenomenon. 

In January 1985 the Federal Aviation Administration (FAA) began developing 
the Integrated FAA Wind Shear Program Plan (ref. “I) aimed at reducing 
the hazard of low-attitude wind shear. The program plan incorporates 
the expertise of industry, universities, and various government agencies, 
such as the National Aeronautics and Space Administration (NASA) , 
the National Oceanic and Atmospheric Administration (NOAA) , and the 
Department of Defense (DOD) , into a 5- to 10-year research and 
development effort. The plan is divided into the following 
f ive~program elements: 

\medskip 

\item{l .}Education, training, and operating procedures 
\item{2.}Ground sensors for the detection of low-level wind shear 


96 



\item{3 . }Airborne sensors and flight guidance systems 
\item{4.}Terminal information systems 

\item{5.}Low-level meteorological hazard characterization 
\medskip 

\noindent Integral to each of these program elements is the fundamental 
need to better understand the physics of low-level encounters. 

NASA’s contribution to the wind shear program is focused primarily on the 
third and fifth program elements. The objective of the NASA research 
effort is to provide the technology base that will permit reduction 
of low-altitude wind shear risk through airborne detection, warning, 
and avoidance. 

This paper is divided into five sections. The first describes the 
modifications required to the vortex-lattice program in order to 
incorporate the wind velocity gradients and to compute their aerodynamic 
effects. The second describes the program checkout and validation. This 
is followed by the formulation of the wind shear aerodynamic 
coefficients and a series of sensitivity studies. The final section 
summarizes the results of this study and lists recommendations for 
further research. 

\bigskip 

\levelone{Symbols> 

\symboltable{15pc> 

{{\bf A} k matrix of shear coefficient slope 
$(\partial/\partial\alpha)$, per rad\cr 
\tableskip 

AR k aspect ratioXcr 
\tableskip 

$a_l , \ldots ,a_8$ k geometry-dependent constants in force equations\cr 
\tableskip 

{\bf B> k matrix of shear coefficient intercept $(\alpha=0)$\cr 
\tableskip 

$b$ k wing span, ft\cr 
\tableskip 

$b_l , \ldots ,b_3$ k geometry-dependent constants in boundary 
condition equation\cr 
\tableskip 

$C_{D}$ k drag coefficient, ${{\rm Drag}\over q_\infty S_{{\rm ref»}$\cr 
\tableskip 

$C_{L}$ k lift coefficient, ${{\rm Lift>\over q_\infty S_{{\rm ref}»$\cr 
\tableskip 

$\ell$ k lift, lb\cr 
\tableskip 

$\tilde{\ell}$ k lift per unit span of line vortex element, lb/ft\cr 
\tableskip 

$N$ k total number of vortex panels\cr 
Xtableskip 

$p$ k roll rate, rad/sec\cr 
Xtableskip 

$x, y, z$ k distance along $X$-, $Y\!$-, and $Z$-axis, respectively, ft\cr 
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\tableskip 

$\alpha$ k angle of attack, rad\cr 
\tableskip 

$\phi$ k planform dihedral angle, rad\cr 
\tableskip 

$\psi$ k sweep angle of spanwise horseshoe vortex element in 
$X$-$Y$ plane, rad\cr 
\tableskip 

\noalign{\lef tline{Subscripts : » 

\tableskip 

$c$ k chordwise vortex element\cr 
\tableskip 

$j$ k index for control point\cr 
\tableskip 

$1$ k left half of planform\cr 
\tableskip 

$n$ k index for elemental panel\cr> # /,%End of symboltable 
\bigskip 

\levelone{Modification of Vortex-Lattice Algorithm} 

The algorithm used in this study was a modified version of the vortex-lattice 
computer program presented in reference~14. The computer program 
presented in the reference was developed to compute the aerodynamic load 
distribution for single or dual planforms in a uniform flow field. This 
program had to be modified to compute the load distributions resulting 
from nonuniform sheared flow fields. The modifications of the boundary 
condition and the force and moment equations are discussed in the 
following sections. 

'///.Def inition on new macro 

\def \bsmatrix#l{\left\{\matrix{#l}\right\» 

\bigskip 

\leveltwo{Def inition of a Spatially Varying Wind Field} 

The local wind velocities for a uniform flow field at a point defined in the 
body-axis system, as shown in figure~l, can be written as 

n 

$$\pmatrix{u_w\cr 

\noalign{\medskip} 

v_w\cr 

\noalign{\medskip} 

w_w\cr} = -U__\infty 
\pmatrix{\cos\alpha\cos\beta\cr 
\noalign{\medskip} 

\sin\beta\cr 

\noalign{\medskip} 

\sin\alpha\co8\beta\cr}\eqno(l)$$ 

7 . 7 . 

where 

Nbigskip 

\indentsymtab{14pc> 

{$u_{w},v_{w} f w_{w}$ k relative wind velocity in $X$-, $Y\!$-, and 
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$Z$-direction, respectively\cr 
\t8bleskip 

$Ui{\infty}$ k free-stream velocity\cr 
\tableskip 

$\alpha$ k angle of attack\cr 
\tableskip 

$\beta$ k sideslip angle\cr> 

\bigskip 

‘///.Figure 1 inserted at end of paragraph 

\midf igure{2 . 5in}{\c {Figure 1. Body-axis system. » 

The nonuniform flow field is defined by adding the local wind velocities 
due to the wind shear to the uniform-flow-field equation: 

7 . 7 . 

$$\pmatrix{u_w\cr 

\noalign{\medskip> 

v_w\cr 

\noalign{\medskip> 

w_w\cr> 

- \pmatrix{u_S\cr 
\noalign{\medskip} 
v_S\cr 

\noalign{\medskip} 

w_S\cr> - U_\infty 
\pmatrix{\cos\alpha\cos\beta\cr 
\noalign{\medskip> 

\sin\beta\cr 

\noalign{\medskip> 

\sin\alpha\cos\beta\cr>\eqno (2) $$ 

n 

The effect of sideslip is not addressed within the limits of this study. For 
zero sideslip, the wind field equation becomes 

U 

$$\pmatrix{u_w\cr 

\noalign{\medskip> 

u_w\cr 

\noalign{\medskip> 

w_w\cr} 

=\pmatrix{u_S\cr 

\noalign{\medskip> 

v_S\cr 

\noalign{\medskip> 

w_S\cr> -U_\infty 
\pmatrix{\cos\alpha\cr 
\noalign{\medskip> 

0\cr 

\noalign{\medskip> 

\sin\alpha\cr>\eqno (3) $$ 

7 . 7 . 

The local wind shear velocity components $u_{S},$ $v_{S},$ and 
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$w_{S}$ are defined in terms of the spatial wind velocity gradients as 

$$\pmatrix{u_S\cr 

\noalign{\medskip> 

v_S\cr 

\noalign{\medskip} 

w__S\cr}\equiv 

\pmatrix{{\partial u_S\over \partial x> k {\partial uJ5\over \partial y> 
k {\partial u_S\over \partial z}\cr 
\noalign{\medskip} 

{\partial v_S\over \partial x> k {\partial v_S\over \partial y> 
k {\partial vJS\over \partial z>\cr 
\noalign{\medskip} 

{\partial w_S\over \partial x> k {\partial w_S\over \partial y> 
k {\partial w_S\over \partial z>\cr> 

\pmatrix {x\cr 
\noalign{\medskip> 
y\cr 

\noalign{\medskip> 

z\cr>\eqno(4)$$ 

\bigskip 

\leveltwo{Boundary Condition} 

\levelthree{No-f low condition} 

One of the fundamental conditions of vortex-lattice theory is the 
\lq\lq no-flow* * condition at the control point of each vortex panel. This 
boundary condition simply states that no flow can pass through the vortex 
panel at the control point, so that the flow is required to be tangent to the 
mean camber line of the surface. The control points are located at the 
three-quarter-chord midspan point of each vortex panel. This boundary 
condition provides the equation used to compute the vortex strength of 
each panel . 

A side view of a vortex panel for a planform with no sideslip or dihedral 
is shown in figure“2. The no-flow condition for a planform of this 
type can be written as 

VI. 

$$\eqalignno{& U_\inf ty\sin(\alpha+\alpha_i) -u_S\sin\alpha_i\cr 
\noalign{\medskip} 

&\qquad=\omega_S \cos\alpha_i+\omega\cos(\alpha+\alpha_i)&(5)\cr}$$ 

VI. 

where 

\medskip 

\indentsymtab{16pc} 

{$\alpha_i$ & local angle of incidence\cr 
\tableskip 

$w$ k local downwash velocity\cr} 

VI. Insert figure 2 at top of column 

\figure{l .82inMFigure 2. Side view of vortex panel.} 

\bigskip 

\levelthree{Planform with dihedral} 


% 
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The boundary condition for a planfonn with dihedral yields a slightly 
different equation for each side of the planform. Figure~3 provides a 
view along the $X$-axis of the left side of a planform with dihedral. 

Figure"4 provides the same view for the right side. The equation for the left 
side is 

VI. 

$$\eqalignno{4r\left [U_\infty\sin(\alpha+\alpha_i)-u_S\sin\alpha_i\right] 

\cos \phi_l+(v+v_S)\sin \phi_l\cr 

\noalign{\medskip> 

&\qquad=\left[w_S\cos\alpha_i+w\cos(\alpha + \alpha_i)\right] 
\cos\phi_l k (6)\cr>$$ 

VI i 

where 

\bigskip 

\indentsymtab{16pc) 

{$v$ k local sidewash velocity\cr 
\tableskip 

$\phi_l$ k dihedral angle for the left side\cr> 

‘/.'/.Insert figures 3 k 4 at top of column 

\figurepar{l . 44in>{Figure 3. View along the $X$-axis of the left side of 
planform with dihedral.) 

\figurepar{l . 32in)<Figure 4. View along the $X$-axis of the right side of 
planform with dihedral.) 

\bigskip 

The equation for the right side is 

VI. 

$$\eqalignno{&\left [U_\infty\sin(\alpha+\alpha_i)-u_S\sin\alpha_i\right] 
\cos\phi_r- (v+v_S) \sin\phi_r\cr 
&\quad=\lef t [w_S\cos \alpha_i + w\cos(\alpha+\alpha_i)\right] 
\cos\phi_r k (7)\cr}$$ 

If $\alpha$ and $\alpha_{i)$ are assumed to be small such that the sine 
of the angle can be approximated by the angle in radians and $\phi$ is 
defined as 

VI. 

$$\phi = \phi_{l) = -\phi_{r)$$ 

VI. 

then the boundary condition can be expressed in the form of a single 
equation as 

VI. 

$$\nineptmath 

\Eqalignno{&{w\over U_\infty)-{v\over U_\infty)\tan\phi\cr 
&\qquad=\alpha+\left(l~(u_S\over U_\infty)\right) 

\alpha_i+{v_S\over U_\infty)\tan\phi-{w_S\over U_\infty) 
fc(8)\cr)$$ 

VI. 

The downwash and sidewash velocities for a particular horseshoe vortex can be 
expressed as 

VI. 

$$\eqalignno{w k = {\Gamma\over 4\pi)F_w k (9)\cr 
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\noalign{\vskiplpc> 

v k = {\Gamma\over 4\pi}F_v k (10)\cr>$$ 




where 

\bigskip 

\ indent s y mt ab{ 1 5pc > 

{$F_w,F_v$ k downwash and sidewash influence functions, respectively\cr 
\tableskip 

$\Gamma$ k vortex strength\cr> 

Xbigskip 

\noindent The influence functions are only dependent upon the planform 
geometry and free-stream Mach number, and therefore require no 
modification for a\break nonuniform wind field. The development 
of the influence functions is provided in reference 14. Incorporating 
the downwash and sidewash equations into the boundary condition 
equation yields 

$$\eqalignno{ (F_w-F_v\tan\phi) {\Gamma\over U_\inf ty> 

k =4\pi\left [\alpha+ \left(l - {u_S\over U_\infty}\right) 
\alpha_i\right . \cr 

\noalign{\medskip> 

&\quad +\left .{v_S\over U_\infty}\tan\phi - 
{w_S\over U_\infty}\right]fc (ll)\cr>$$ 

U 

Note that the wind shear velocities effectively act as 
an incremental change in the local angle of attack of the vortex 
panel. This is more clearly seen by rewriting the boundary condition as 
•///. 

$$ (F_w-F_v\tan\phi) {\Gamma\over U_\inf ty> 

=4\pi (\alpha+\alpha_i+\alpha_S)\eqno(12)$$ 

where $\alpha_{S>$ is an additional local angle of attack 
due to the wind shear velocities: 

n 

$$\alpha_S= - {u_S\over U_\inf ty}\alpha_i+{v_S\over U_\infty> 
\tan\phi-{w_S\over U_\inf ty>\eqno(13)$$ 

U 

The effect of the wind shear distribution across the planform is therefore 
analogous to distortion of the planform shape through twist or camber, as was 
noted in referenced. 


Xbigskip 

\levelone{Sensitivity Study Results} 

The aerodynamic effects of wind shear were investigated through a series of 
sensitivity studies using the modified vortex-lattice program and 
were characterized in the form of shear coefficients. The first of 
these studies focused on determining the effect of the vortex-lattice 
distribution on the computation of the shear coefficients. The 
second study examined the variation of the wind shear effect with 
planform geometry. The final study used a wing and stabilizer 
configuration to determine the magnitude of the wind shear effect 
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in a simulated microburst. 

\bigskip 

\leveltwo{Eff ect of Vortex-Lattice Distribution} 

The objective of the first of the series of sensitivity studies was to 
determine the effect of the vortex-lattice distribution on the computation 
of the shear coefficients. This was done by varying the spanwise and 
chordwise distributions of the vortices for a particular wing geometry. The 
wing planform used in this part of the study was configuration"^ of table~2. 
The vortex distribution was varied for each of the nine individual shear 
conditions, with the origin of the shear coincident with the aerodynamic 
center of the planform. 

Those shear coefficients which had a magnitude of zero or nearly 
zero were omitted. The variation in the value of the shear 
coefficients with vortex-lattice arrangement demonstrated similar trends 
as those reported for the aerodynamic coefficients in ref erence~13. 

Increasing the spanwise $N_s$ and chordwise $N_c$ distributions of vortices 
resulted in an asymptotic convergence of the shear coefficient value. 

Spanwise distributions less than 30 and chordwise distributions less than 
4 resulted in significant variations in the computed coefficient values. 
\bigskip 

\leveltwo{Planform Geometry Effects} 

The objective of this sensitivity study was to determine how the wind shear 
effect varied with\break planform geometry. This was done by varying the 
sweep, taper, aspect ratio, and dihedral of a simple wing configuration and 
comparing the resultant effect on the shear coefficient values. Planform 
configurations"^ to 11 of tabled were the wing geometries used. The 
baseline planform was configuration"^. The aspect ratio effect was obtained 
through comparison of the baseline with conf igurations~3 and 4; the dihedral 
effect was obtained through comparison with conf igurations~6 and 7; 
the sweep effect was obtained with conf igurations"^ and 9; and the taper ratio 
effect was obtained with configurations"^ and 11. All the planform 
configurations had identical wing areas, with no 

camber or twist. A vortex distribution of 4~chordwise and 40~spanwise was 
used in computing the shear coefficients, with the origin of the shear 
coincident with the aerodynamic center of the planforms. 

\bigskip 

\levelone{Concluding Remarks} 

The objective of this study was to investigate and characterize the 
aerodynamic effects of shear flow through a series of sensitivity studies of 
the wind shear components and wing planform geometry parameters. In addition 
to the data base developed through these sensitivity studies, several 
pertinent results were \hbox{established.} 

\bigskip 

\item{l.} A method of characterizing the aerodynamic effect of wind shear in 
the form of wind shear aerodynamic coefficients was formulated. 

\item{2.} A method of modifying the boundary condition, the wind field, and 
the force and moment equations of a vortex-lattice algorithm, for 
computing the aerodynamic effects of wind shear was demonstrated. This 
approach should be directly applicable to more complex potential flow 
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algorithms. 

\item{3.} The magnitudes of the aerodynamic effects were demonstrated by 
computation of the changes in the aerodynamic coefficients of a 
conventional wing and stabilizer conf iguration on a fixed flight path 
through a simulated microburst. 

\bigskip 

This study was, however, limited in several respects. The effect of 
sideslip angle was not accounted for in the formulation of the wind shear 
aerodynamic coefficients. To account for this effect, an additional 
matrix of sideslip-dependent wind shear aerodynamic coefficients should 
be added to the formulation. The limits of potential flow theory restrict 
the results to the linear angle-of -attack range. The thin-wing 
approximation of vortex-lattice approach is an additional limitation. 
Perhaps the greatest limitation of the study was the exclusion of the 
effects of the fuselage and vertical surfaces. The vertical surfaces 
(fin and rudder) should affect the lateral wind shear aerodynamic 
coefficients in a similar manner as the horizontal stabilizer affected 
the longitudinal coefficients. The fuselage effect in sheared flow may 
also be significant. Just as a cylinder in a flow with circulation produces 
lift, a fuselage in a sheared flow field may produce significant forces. 
\bigskip 
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The following is the file for the appendix of our sample report. Note that this file uses 
\splitcol, and therefore the page will be balanced. Had there been no figures inserted in the 
text of the report (previous file), it too could have been processed with \splitcol and then the 
last page would have been balanced. 


•///•File for appendix 
\input larcmacs 
\pageno6 Hbegin on p. 6 

\splitcol %%Use format that allows format to be changed from 1 to 2 columns 

\begindoublecol */o’/*begin double-column format 

\levelone{Appendix> 

\levelone{Program Checkout and Validation} 

Once the computer program had been modified to incorporate the effects of 
wind shear on the planform load distribution, some means of checking the 
program had to be devised. Since measurements of this type have not been 
conducted, a direct comparison of measured and computed results was not 
possible. However, if the appropriate spatial wind velocity 
derivatives are coupled, a curved flow field synonymous to rotary motion 
can be modeled. Through imposition of this type of flow field and computation 
of the resultant change in the planform load distribution, the rotary 
stability derivatives can be computed. The modified program could then 
be checked by a comparison of the computed rotary stability derivatives 
with values measured in the wind tunnel or with values computed with other 
\hbox{algorithms . } 

A rolling motion can be simulated if the $\partial w_{S}/\partial y$ 
and $\partial v_{S}/\partial z$ terms are coupled. The coupled 
terms must be of equal magnitude to simulate the rotary motion: 

•///. 

$$p = {l\over 2}\left ({\partial v_{S}\over \partial z} 

- {\partial w_{s}\over \partial y}\right)\Eqno(Al)$$ 

•///• 

In a similar fashion, pitching and yawing motion can be simulated with the 
following equations: 

%% 

$$\Eqalignno{q k * {l\over 2}\left ({\partial w_{S}\over\partial x} 

- Apartial u_{S}\over\partial z}\right) k (A2)\cr 
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\noalign{\vskiplpc> 

r & = {l\over 2>\left ({\partial u_{S}\over \partial y> 

* {\partial v_{S}\over\partial x>\right) k (A3)\cr>$$ 

%% 

A direct comparison of the stability derivatives computed with the 
algorithm presented in reference~16 was possible for planforms without 
dihedral. Such a comparison was made with planform configuration"! of 
table"2. The calculated results were derived for 4"chordwise and 30"spanwise 
horseshoe vortices. This provided a fairly even distribution of 
vortices about the planform and a reasonable computation time. No effort 
was made, at this point in the study, to determine the sensitivity of the 
vortex distribution on the coefficients being computed or to optimize the 
distribution accordingly. The stability derivatives computed by the 
two methods were identical to the fifth significant digit. 

The computed results were also compared with wind-tunnel measured values 
for planform configurations"! and"2. .The wind-tunnel data were extracted 
from a series of studies conducted by the National Advisory Committee for 
Aeronautics (NACA) during the late forties. The studies investigated the 
effect of various wing planform geometry parameters, such as sweep, taper, 
and aspect ratio, on the rotary stability derivatives (refs. "17 to 22). 

The majority of the wind-tunnel data were measured in a special low-speed 
stability tunnel which generated curved flow fields using special screens 
and curved test section walls. A photograph of the test section, set up 
to measure the effects of yawing motion, is shown in figure"5. 

Planform configurations"! and 2 were common to most of these studies 
and provided a considerable data base to compare with the 
analytical results of the modified program. The airfoil for both 
configurations was an NACA"0012 section perpendicular to the planform 
leading edge. Figures"6 and 7 show the calculated and 
experimental values of $C_{L}$, $C_{m}$, $C_{L_{q»$, $C_{m_{q»$, 
$C_{l_{p»$ , $C_{l_{r»$, $C_{n_{p»$ , $C_{n_{r»$, $C_{Y_{p»$, and 
*C_{Y_{r}}$ for configurations"! and 2, respectively. 

The calculated results compared favorably with the wind-tunnel data up to 
$C_{L}$ values of about 0.5, or roughly a $10"\circ$ angle of attack. The 
breakdown in the vortex-lattice theory at the higher $C_{L}$ values was not 
unexpected, as this is a basic limit of linear potential flow theory. The 
rolling and yawing derivatives provided much better agreement with the 
^ind-tunnel data than did the pitching derivatives. This agreement 
was attributed to the relatively few chordwise vortices used in the 
computation. Reference"!4 recommends use of 10 or more chordwise 
vortices to compute such longitudinal variations. The favorable 
comparison of the stability derivatives at the lower $C_{L}$ 
values was taken as a validation of the modifications made to the 
vortex-lattice program. 

\enddoublecol # /,%End double columns; page will be balanced 
\bye 
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Summary 

Wimi shear is considered by many in the aviation 
community to be one of the major safety issues facing 
their industry. The Federal Aviation Administration 
has addressed this problem through an integrated wind 
shear program plan, which incorporates the expertise of 
industry, universities, and various government agencies 
such as the National Aeronautics and Space Adminis- 
tration, the National Oceanic and Atmospheric Admin- 
istration, and the Department of Defense. The plan 
is aimed at reducing the hazard of low-attitude wind 
shear through improved training and operating proce- 
dures, wind shear detection systems, and flight guidance 
systems. 

Introduction 

Wind shear is considered by many in the aviation 
industry to be one of their major safety issues. Listed 
in table 1 are 32 U.S. aircraft accidents or incidents that 
have occurred from 1964 to 1985 and were attributed 
to low-altitude wind shear (refs. 1 and 2). The crash of 
Delta flight 191 on August 2, 1985, in which 135 people 
died while on an approach to landing at Dallas-Fort 
Worth International Airport, is the latest reminder of 
the danger of this weather phenomenon. 

In January 1985 the Federal Aviation Administra- 
tion (FA A) began developing the Integrated FA A Wind 
Shear Program Plan (ref. 1) aimed at reducing the haz- 
ard of low-attitude wind shear. The program plan incor- 
porates the expertise of industry, universities, and vari- 
ous government agencies, such as the National Aeronau- 
tics and Space Administration (NASA), the National 
Oceanic and Atmospheric Administration (NOAA), and 
the Department of Defense (DOD), into a 5- to 10-year 
research and development effort. The plan is divided 
into the following five program elements: 

1. Education, training, and operating procedures 

2. Ground sensors for the detection of low-level wind 

shear 

3. Airborne sensors and flight guidance systems 

4. Terminal information systems 

5. Low-level meteorological hazard characterization 

Integral to each of these program elements is the fun- 
damental need to better understand the physics of low- 
level encounters. 

NASA’s contribution to the wind shear program is 
focused primarily on the third and fifth program ele- 
ments. The objective of the NASA research effort is 
to provide the technology base that will permit reduc- 
tion of low-altitude wind shear risk through airborne 
detection, warning, and avoidance. 

This paper is divided into five sections. The first de- 
scribes the modifications required to the vortex-lattice 


program in order to incorporate the wind velocity gra- 
dients and to compute their aerodynamic effects. The 
second describes the program checkout and validation. 
This is followed by the formulation of the wind shear 
aerodynamic coefficients and a series of sensitivity stud- 
ies. The final section summarizes the results of this 
study and lists recommendations for further research. 

Symbols 

A matrix of shear coefficient slope ( d/da ), 

per rad 

AR aspect ratio 

01. . . . , ag geometry-dependent constants in force 

equations 

B matrix of shear coefficient intercept 

(a = 0) 

b wing span, ft 

61. . . • , 63 geometry- dependent constants in bound- 

ary condition equation 

Cd drag coefficient , 

Cl lift coefficient, ■ — 

Qao&rmf 

t lift, lb 

i lift per unit span of line vortex element, 

lb/ft 

N total number of vortex panels 

p roll rate, rad /sec 

x, y,z distance along X-, V-, and Z-axis, 

respectively, ft 

a angle of attack, rad 

4> planform dihedral angle, rad 

V sweep angle of spanwise horseshoe 

vortex element in X-Y plane, rad 

Subscripts: 

c chordwise vortex element 

j index for control point 

/ left half of planform 

n index for elemental panel 

Modification of Vortex-Lattice 
Algorithm 

The algorithm used in this study was a modified ver- 
sion of the vortex- lattice computer program presented 
in reference 14. The computer program presented in 
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the reference was developed to compute the aerody- 
namic load distribution for single or dual planforms in 
a uniform How Held. This program had to be modi- 
Hed to compute the load distributions resulting from 
nonuniform sheared How Helds. The modifications of 
the boundary condition and the force and moment equa- 
tions are discussed in the following sections. 


Definition of a Spatially Varying Wind 
Field 

The local wind velocities for a uniform flow field at 
a point defined in the body-axis system, as shown in 
figure 1, can be written as 


Uw \ 

/COS Or COS /3\ 


V w 

= -Uoo sin/3 J 

(i) 

W w / 

V sin 0 cos 0 ) 



where 


relative wind velocity in X-, K-, and 
Z-direction, respectively 

U<x> free-stream velocity 

o angle of attack 

0 sideslip angle 


Figure 2. Side view of vortex panel. 

The effect of sideslip is not addressed within the limits 
of this study. For zero sideslip, the wind field equation 
becomes 



The local wind shear velocity components , U5 , and 
w$ are defined in terms of the spatial wind velocity 
gradients as 



Figure 1. Body-axis system. 

The nonuniform flow field is defined by adding the 
local wind velocities due to the wind shear to the 
uniform-flow-field equation: 


Boundary Condition 

No-flow condition. One of the fundamental con- 
ditions of vortex- lattice theory is the “no-flow” condi- 
tion at the control point of each vortex panel. This 
boundary condition simply states that no flow can pass 
through the vortex panel at the control point, so that 
the flow is required to be tangent to the mean camber 
line of the surface. The control points are located at 
the three-quarter-chord midspan point of each vortex 
panel. This boundary condition provides the equation 
used to compute the vortex strength of each panel. 

A side view of a vortex panel for a planform with 
no sideslip or dihedral is shown in figure 2. The no-flow 
condition for a planform of this type can be written as 

Uoo sin(a + a,) - u§ sin a* 

= Ug cos + u cos(a 4- or,) (5) 


\ 

( us ] 


/COSO cos J\ 


where 


Vv 

= V S 

-U oo 

sin 0 

(2) 

<*i 

local angle of incidence 

W w / 

\w s / 


V sin 0 cos 0 J 


w 

local downwash velocity 
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The downwash and sidewash velocities for a particular 
horseshoe vortex can be expressed as 


Figure 3. View along the X-axis of the left side of planform 
with dihedral. 


Figure 4. View along the X-axis of the right side of planform 
with dihedral. 

Planform with dihedral. The boundary condition 
for a planform with dihedral yields a slightly different 
equation for each 9ide of the planform. Figure 3 pro- 
vides a view along the X-axis of the left side of a plan- 
form with dihedral. Figure 4 provides the same view 
for the right side. The equation for the left side is 

\Voo sin(a + a,*) - u$ sin a,] cos 0/ + (u + 1*5) sin 0/ 

= [u>5 cos a, + it; cos(a + a,)] cos (6) 

where 

v local sidewash velocity 

0/ dihedral angle for the left side 

The equation for the right side is 

[C/00 sin(a - q j ) - us sin a*] cos 0 r - (r + v$) sin 0 r 
= [teg cosa, + tncos(a 4- Q, )lcos0 r (7) 

If a and a, are assumed to be small such that the 
sine of the angle can be approximated by the angle in 
radians and O is defined as 


0=0/ = ~0r 


then the boundary condition can be expressed in the 
form of a single equation as 


w v 



w = 



!‘l) 


r 


V 4w 


F v 


( 10 ) 


where 

Fu,,Fv downwash and sidewash influence 
functions, respectively 

T vortex strength 


The influence functions are only dependent upon the 
planform geometry and free-stream Mach number, and 
therefore require no modification for a 
nonunifonn wind field. The development of the in- 
fluence functions is provided in reference 14. Incorpo- 
rating the downwash and sidewash equations into the 
boundary condition equation yields 



Note that the wind shear velocities effectively act as an 
incremental change in the local angle of attack of the 
vortex panel. This is more clearly seen by rewriting the 
boundary condition as 

r 

(F w - F v tan0)— — = 47r(a + a, f 05) (12) 

C'OO 

where Q5 is an additional local angle of attack due to 
the wind shear velocities: 


a s = 


us , V S t 

— Q » + — tan0 

OO L/ no 


(13) 


The effect of the wind shear distribution across the 
planform is therefore analogous to distortion of the 
planform shape through twist or camber, as was noted 
in reference 9. 


Sensitivity Study Results 

The aerodynamic effects of wind shear were inves- 
tigated through a series of sensitivity studies using the 
modified vortex- lattice program and were characterized 
in the form of shear coefficients. The first of these 
studies focused on determining the effect of the vortex- 
lattice distribution on the computation of the shear co- 
efficients. The second study examined the variation of 
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the wind shear effect with planform geometry. The fi- 
nal study used a wing and stabilizer configuration to 
determine the magnitude of the wind shear effect in a 
simulated microburst. 

Effect of Vortex-Lattice Distribution 

The objective of the first of the series of sensitiv- 
ity studies was to determine the effect of the vortex- 
lattice distribution on the computation of the shear co- 
efficients, This was done by varying the spanwise and 
chordwise distributions of the vortices for a particular 
wing geometry. The wing planform used in this part of 
the study was configuration 2 of table 2. The vortex 
distribution was varied for each of the nine individual 
shear conditions, with the origin of the shear coincident 
with the aerodynamic center of the planform. 

Those shear coefficients which had a magnitude of 
zero or nearly zero were omitted. The variation in 
the value of the shear coefficients with vortex-lattice 
arrangement demonstrated similar trends as those re- 
ported for the aerodynamic coefficients in reference 13. 
Increasing the spanwise N a and chordwise N c distribu- 
tions of vortices resulted in an a symptotic convergence 
of the shear coefficient value. Spanwise distributions 
less than 30 and chordwise distributions less than 4 re- 
sulted in significant variations in the computed coeffi- 
cient values. 

Planform Geometry Effects 

The objective of this sensitivity study was to deter- 
mine how the wind shear effect varied with 
planform geometry. This was done by varying the 
sweep, taper, aspect ratio, and dihedral of a simple wing 
configuration and comparing the resultant effect on the 
shear coefficient values. Planform configurations 3 to 11 
of table 2 were the wing geometries used. The baseline 
planform was configuration 5. The aspect ratio effect 
was obtained through comparison of the baseline with 
configurations 3 and 4; the dihedral effect was obtained 
through comparison with configurations 6 and 7; the 
sweep effect was obtained with configurations 8 and 9; 
and the taper ratio effect was obtained with configura- 
tions 10 and 11. All the planform configurations had 
identical wing areas, with no camber or twist. A vortex 
distribution of 4 chordwise and 40 spanwise was used 
in computing the shear coefficients, with the origin of 
the shear coincident with the aerodynamic center of the 
planforms. 

Concluding Remarks 

The objective of this study was to investigate 
and characterize the aerodynamic effects of shear flow 
through a series of sensitivity studies of the wind 

4 


shear components and wing planform geometry param- 
eters. In addition to the data base developed through 
these sensitivity studies, several pertinent results were 
established. 

1. A method of characterizing the aerodynamic effect 
of wind shear in the form of wind shear aerodynamic 
coefficients was formulated. 

2. A method of modifying the boundary condition, the 
wind field, and the force and moment equations of a 
vortex- lattice algorithm, for computing the aerody- 
namic effects of wind shear was demonstrated. This 
approach should be directly applicable to more com- 
plex potential ffow algorithms. 

3. The magnitudes of the aerodynamic effects were 
demonstrated by computation of the changes in 
the aerodynamic coefficients of a conventional wing 
and stabilizer configuration on a fixed flight path 
through a simulated microburst. 

This study was, however, limited in several respects. 
The effect of sideslip angle was not accounted for in the 
formulation of the wind shear aerodynamic coefficients. 
To account for this effect, an additional matrix of 
sideslip-dependent wind shear aerodynamic coefficients 
should be added to the formulation. The limits of 
potential flow theory restrict the results to the linear 
angle-of-attack range. The thin-wing approximation 
of vortex- lattice approach is an additional limitation. 
Perhaps the greatest limitation of the study was the 
exclusion of the effects of the fuselage and vertical 
surfaces. The vertical surfaces (fin and rudder) should 
affect the lateral wind shear aerodynamic coefficients in 
a similar manner as the horizontal stabilizer affected the 
longitudinal coefficients. The fuselage effect in sheared 
flow may also be significant. Just as a cylinder in a flow 
with circulation produces lift, a fuselage in a sheared 
flow field may produce significant forces. 
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Appendix 

Program Checkout and Validation 

Once the computer program had been modified to 
incorporate the effects of wind shear on the planform 
load distribution, some means of checking the program 
had to be devised. Since measurements of this type 
have not been conducted, a direct comparison of mea- 
sured and computed results was not possible. However, 
if the appropriate spatial wind velocity derivatives are 
coupled, a curved flow field synonymous to rotary mo- 
tion can be modeled. Through imposition of this type 
of flow field and computation of the resultant change 
in the planform load distribution, the rotary stability 
derivatives can be computed. The modified program 
could then be checked by a comparison of the com- 
puted rotary stability derivatives with values measured 
in the wind tunnel or with values computed with other 
algorithms. 

A rolling motion can be simulated if the dws/dy and 
dvs/dz terms are coupled. The coupled terms must be 
of equal magnitude to simulate the rotary motion: 

'-{(£- 5 ) ,ai1 

In a similar fashion, pitching and yawing motion can be 
simulated with the following equations: 

-S(£-Sf) <** 

'-}($?-!?) <**> 

A direct comparison of the stability derivatives com- 
puted with the algorithm presented in reference 16 was 
possible for planforms without dihedral. Such a com- 
parison was made with planform configuration 1 of ta- 
ble 2. The calculated results were derived for 4 chord- 
wise and 30 spanwise horseshoe vortices. This provided 
a fairly even distribution of vortices about the plan- 
form and a reasonable computation time. No effort was 


made, at this point in the study, to determine the sensi 
tivity of the vortex distribution on the coefficients being 
computed or to optimize the distribution accordingly. 
The stability derivatives computed by the two methods 
were identical to the fifth significant digit. 

The computed results were also compared witti 
wind-tunnel measured values for planform configura- 
tions 1 and 2. The wind-tunnel data were extracted 
from a series of studies conducted by the National Ad- 
visory Committee for Aeronautics (NACA) during the 
late forties. The studies investigated the effect of vari- 
ous wing planform geometry parameters, such as sweep, 
taper, and aspect ratio, on the rotary stability deriva- 
tives (refs. 17 to 22). The majority of the wind-tunnel 
data were measured in a special low-speed stability tun- 
nel which generated curved flow fields using special 
screens and curved test section walls. A photograph 
of the test section, set up to measure the effects of yaw- 
ing motion, is shown in figure 5. Planform configura- 
tions 1 and 2 were common to most of these studies and 
provided a considerable data base to compare with the 
analytical results of the modified program. The airfoil 
for both configurations was an NACA 0012 section per- 
pendicular to the planform leading edge. Figures 6 and 
7 show the calculated and experimental values of C/,, 
Cm, C L ,, Cm,, C, r , C lr , Cnp, C„ r , C Yf , and Cy, for 
configurations 1 and 2, respectively. 

The calculated results compared favorably with the 
wind-tunnel data up to Cl values of about 0.5, or 
roughly a 10° angle of attack. The breakdown in the 
vortex-lattice theory at the higher Cl values was not 
unexpected, as this is a basic limit of linear potential 
flow theory. The rolling and yawing derivatives pro- 
vided much better agreement with the wind-tunnel data 
than did the pitching derivatives. This agreement was 
attributed to the relatively few chordwise vortices used 
in the computation. Reference 14 recommends use of 10 
or more chordwise vortices to compute such longitudi- 
nal variations. The favorable comparison of the stability 
derivatives at the lower Cl values was taken as a val- 
idation of the modifications made to the vortex-lattice 
program. 
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